Altos 586 User manual

-
COMPUTER SYSTEMS
ALTOS 586 and ACS 8600
Computer Systems
XENIXDevelopment
System
Programmer's
Reference Guide
Part Number: 690-13500-001 May 1983

-
[Y\it",-v,_ai ~c~ "1
L
"h
\ '-1 - ?, -';, U A~)
ALTOS 586 ARD ACS 8688 COIIPtrnR SYSTEMS
XENIX DEVELOPMENT SYSTEM
PROGRAMMER'S REFERENCE GUIDE
Altos Computer Systems
2641 Orchard Park Way
San Jose, CA 95134
THE INFORllATION IN THIS DOCUMEIft IS SUBJECT TO
CHANGE WITHOUT NOTICE. NEW EDITIONS OF THIS
DOCUMEIft' WILL INCORPORATE CHARGES AS THEY ARE
PUBLISHED.
Copyright ©1983. All rights reserved. Altos Coaputer Systeas.
ALTOS Manual Number: 698-13588-881
May 1983

ACKNOWLEDGEME~S
ALTOS is a registered trademark of Altos Computer
Systems.
XENIX is a trademark of Microsoft, Incorporated and
is a l6-bit microcomputer implementation of the
UNIX operating system, version 7.
UNIX is a trademark of Bell Laboratories
UNET is a trademark of 3eom Corporation

TABLE OF CONTENTS
1. INTRODUCTION
USING THIS MANUAL
Purpose/Scope
Organization
OTHER DOCUMENTATION AVAILABLE
Altos 586 or ACS 8699 Operator's Guide
Altos Introduction to XENIX Manual
XENIX Reference Card
Altos Application Software Guide
Altos UNET User Guide
Bell Laboratories Manuals
UNIX Programmer's Manual
Commercially Available Books
2. USIBG XENIX
TOPICS COVERED IN INTRODUCTION TO XENIX MANUAL
INSTALLING XENIX DEVELOPMENT SYSTEM
LEARN PROGRAM
Installing Learn
Running Learn
CREATING NEW MENUS
3. UTILITY PROGRAMS RBFERBBCE GUIDE
USEFUL UTILITIES
UNIX MANUAL CHANGES AND ADDITIONS
ADD.CT(l)
ADD.HD(l)
AEMAIL( 1)
APROPOS (1)
BSH(l)
CSH( 1)
CXREF(l)
DATE(l)
DIGEST(l)
DISABLE(C)
DUMP.HD(l)
ENABLE (C)
EDIT(l)
EX (1)
FCOPY(l)
FINGER(l)
FLEECE(l)
i
1-2
1-2
1-2
1-4
1-4
1-4
1-4
1-4
1-4
1-4
1-4
1-5
2-2
2-3
2-7
2-7
2-8
2-9
3-1
3-3
3-6
3-7
3-8
3-19A
3-11
3-15
3-38A
3-38B
3-39
3-49A
3-49B
3-49C
3-41
3-45
3-49
3-49A
3-49B

TABLE OF COftBftS
3 • UTILI'l'Y PROGRAMS REFERENCE GUIDE (Continued)
FOLD(l)
FORMAT(l)
FROM(I)
FSCK (1)
FTP(I)
HEAD(l)
IUL (1)
LAST(I)
LAYOUT (1)
LEAVE(l)
LS(l)
MAIL(I)
MAKE.HD(I)
MAKEWHATIS(I)
MAP(l)
MKCONF(IM)
MODEM(l), UNMODEM(l)
MORE (1)
MULTIUSER(I)
PAGE (1)
PRINTENV(I)
PS( 1)
RANLIB(l)
RESET(I)
RESTORE.HD(I)
SDDATE(IM)
SETMODE(l)
SIZEFS(l)
TAR(I)
TRANSP(l)
UA(l)
VI (1)
LOCKING(2)
RDCHK (2)
CURSES(3)
MENUS (5)
TERMCAP(5)
TTYTYPE(5)
ii
3-49C
3-59
3-59A
3-51
3-54
3-55A
3-55B
3-55C
3-56
3-57A
3-58
3-61
3-68A
3-68B
3-69
3-69A
3-69C
3-69D
3-79
3-79A
3-71
3-72
3-74A
3-75
3-75A
3-75B
3-76
3-77
3-78
3-89A
3-81
3-85
3-87
3-89
3-99
3-92
3-97
3-198

APPBNDICBS:
A. NUMBRIC FORMATS, C, AND FORTRAN
INTEGER FORMATS
FLOATING-POINT FORMATS
VALUES IN MEMORY
B. SAMPLB LIST OF XBNIX DEVELOPMBNT SYSTEM UTILITIBS
C. TRANSFBRRIRG FILBS BETNEER ACS 8681 AND ALTOS 586 OR OTHER
COMPUTER SYSTEIIS (ASY.CBRaBOUS COIUIURICATIORS)
USING CU FACILITY
TRANSFERRING FILES UNDER UUCP FACILITY
CONNECTING THE ACS 8699 AND THE 586
PREPARING THE CONFIGURATION FILES
Recommended
Entries
IF YOU HAVE SPECIAL REQUIREMENTS
Assigning the System Names
Defining the Communications Line Characteristics
Supplying the Login Information
Defining the File Accessibility
DISABLING AND ENABLING THE TTY PORTS
TESTING THE UUCP NETWORK
COPYING FILES USING UUCP
USING THE UUCP COMMAND
USING MODEMS WITH ALTOS XENIX SYSTEMS
D. 8886 ASSEllBLY LARGOAGE RBFERERCE MANUAL
XENIX Software Development Extract from Microsoft Manual
E. TUTORIAL AND REFERBRCB MATERIAL
(UNIVERSITY OF CALIFORNIA, BERKELEY MANUALS)
An Introduction to the C Shell
An Introduction to Display Editing with Vi
Quick Reference for Ex,Vi
Ex Reference Manual
Edit: A Tutorial
, Ex/Edit Command Summary (Version 3.6)
Mail Reference Manual
-ME Reference Manual
Screen Updating and Cursor Movement Optimization: A Library
Package
iii

OTHER DOCUllEftATION AVAILABLE
The following documentation is furnished with your XENIX
operating system. The only commercially-available book that is
provided is A User Guide to the UNIX Syste ••
Altos 586 or ACS 8688 Operator's Guide
This manual describes the Altos computer system and its operating
specifications. It provides step-by-step procedures on how to
unpack and set up the computer system, how to install
peripherals, how to verify proper functioning of the system, and
briefly describes how to use the Altos diagnostics software.
Altos Introduction to XENIX Manual
This manual, describes the Altos implementation of the XENIX
operating system on the Altos 586 and ACS 86~~ computer systems.
It provides background information and step-by-step procedures,
which are primarily aimed at a first-time computer user, on how
to install XENIX, how to log on/off, how to shut down the system
properly, how to save and restore files, and describes system
maintenance.
XENIX Reference Card
A concise reference card, which contains information on how to
use the Al tos implemen ta tion of XENIX, descr ibes the XENIX
commands, and lists the Business Shell (BSH) menus.
Altos Application Software Guide
(The ABS Shell is an optional package.) The Altos XENIX Applica-
tions Software Guide provides information on how to install the
optional ABS Menu Shell and the application programs, and how to
access the ABS menus.
Altos URET User Guide
(The communication network services is an optional package.)
This document provides information on how to install the optional
communication network services and how to use them.
Bell Laboratories Manuals
UNIX Progra •• er's Manual, Seventh Edition. This is a three-
volume set.
Volume 1 provides general information about UNIX and
about the manual set. It contains reference informa-
tion on utilities and system calls, organized into
chapters.
1-4

USING THIS MARUAL
purpose/Scope
This manual describes items that are unique to the Altos
implementation of the XENIX operating system or that are useful
for the programmer or advanced system user. It also serves as a
guide to the other documentation that is available on XENIX/UNIX.
Organization
This manual is divided into three chapters:
Chapter I lists other Altos documents that you receive as part of
your XENIX operating system. It also lists commercially-avail-
able documentation.
Chapter 2 provides instructions for installing the XENIX Develop-
ment System, and discusses the online tutorial, learn, and tells
you how to create new menus.
Chapter 3 lists useful utilities and describes the changes and
additions that exist between the Altos implementation of XENIX
and the Bell Laboratories Standard Version 7 of the UNIX
operating system.
The variations and additions are documented in the standard Bell
Laboratories format. The Altos documentation can be left in this
supplement or can be inserted into the Bell Laboratories UNIX
Programmer's Manual.
The Appendices contain general reference material.
Appendix A. Numeric Formats, C, and Fortran 77:
Reference information on the internal format used
for numerical representation in these languages.
Appendix B. Sample List of XENIX Utilities:
A sample list of utilities furnished with your
system.
Appendix C. Transferring Files Between ACS 8600 and
ALTOS 586 or Other Computer Systems
(Asynchronous Communications):
A description on how to transfer files between the
ACS 8600 and Altos 586 XENIX computer systems, or
between two Altos XENIX computer systems which
support asynchronous (serial) communications. It
discusses the ~ (call UNIX) and ~ (UNIX-to-UNIX
copy) facilities. For ACS 8600 versions 2.2d and
Altos 586 versions 2.3 and higher, refer to a
description of the File Transfer Utility for Xenix-
1-2