DOMAIN(1) Domain/OS SysV DOMAIN(1)
NAME
domain - Domain/OS-specific commands and extensions
DESCRIPTION
While providing all of the significant capacity of System V Release 3,
Domain/OS SysV actually represents only a subset of the greater capacity
of Domain/OS. Furthermore, Domain/OS SysV omits some features of System
V that are irrelevant to Apollo(R) workstations. The following
paragraphs describe aspects that are visible to the Domain/OS SysV user
and summarize features of System V not implemented under Domain/OS SysV.
Domain/OS Additions to SysV
Pages that describe the Domain/OS-specific commands are identified with
the page heading "Domain/OS SysV;" pages describing standard System V
UNIX commands are "SysV".
The /usr/apollo/bin Directory
All systems, even if they only have the Aegis environment, now have a
/usr/apollo directory. It contains certain Domain extensions to the UNIX
environment. It also includes C include files for Domain system calls, as
well as other added-value files.
The /usr/apollo/bin directory contains Domain commands that apply to all
three environments or extend the UNIX environment. The following
Domain/OS-specific commands appear in /usr/apollo/bin:
bldt Displays information about the version of Domain/OS.
chacl Changes the entries in an object's access control list (ACL).
cpacl Copies access control lists (ACLs).
cpscr Copies the current screen image, without clearing it, to the
file you specify.
crddf Creates, displays, or modifies a device descriptor file
(DDF).
crp Creates a process on a remote node.
crpad Creates a transcript pad, copies a file (or standard input)
into that pad, and then opens a window into the pad.
crty Creates a new type. It creates an identifier for the new
type, and associates it with the supplied type name. New
types are used to identify a new kind of manager for streams.
crtyobj Creates an object module that contains a global symbol with
the type UID. This module is bound with type managers. The
variable is passed into calls to trait_$mgr_dcl to declare
support for the specified type.
cvt_font Converts SR9 font files to the new font format for SR10.
cvtname Converts SR9 pathnames between upper and lowercase and
preserve colons.
cvtrgy Allows the system administrator to generate an SR10 format
registry database from SR9.7 registry files, or generates
SR9.7 registry files with data from the SR10 registry.
dbacl Provides an interactive menu-based editor for manipulating
Access Control Lists (ACLs).
dde Allows you to load and debug programs written in any
programming language supported by the Domain/OS operating
system, including assembler.
dlty Deletes a type and any installed type manager.
dm Contains a list of Display Manager commands.
dspst Displays process statistics in a graphical, bar-chart fashion
within the current process window.
edfont Allows you to create, edit and view character font files.
edmtdesc Allows you to create, list, and modify the magnetic tape
descriptor object.
emt Allows your node to emulate an ASCII terminal connected to
another computer. This asynchronous connection exists
through a stream opened on one of the node's SIO lines. emt
also permits ASCII file transfer between your node and the
remote host.
esa Displays the address of an external symbol in an installed
library. This command is primarily intended for system-level
debugging.
fst Prints information about the most recent fault that occurred
in the process.
hpc The hpc (histogram_program_counter), part of Domain/PAK
(Domain Performance Analysis Kit), looks at the performance
of programs at the PC level.
intm Installs a type manager for the type_name.
inty Installs a type from one node to another.
iso Converts files written with the overloaded 7-bit national
fonts to the International Standards Organization (ISO) 8-bit
format. This includes: french_to_iso, german_to_iso,
nor.dan_to_iso, swedish_to_iso, swiss_to_iso, and uk_to_iso
kbm Allows you to set the characteristics for the keyboard.
las Produces a list of objects mapped into the address space.
lbr2ar Converts pre-SR10 lbr library files containing object modules
in OBJ format to SR10 ar library archive files containing
object modules in COFF format.
lcm Loads a color map from a file that specifies a set of color
map entries.
llib Lists those libraries which have been installed in the
current process via the build-in inlib shell.
llkob Lsts the locked objects resident on volumes mounted on this
node, and objects resident in other nodes that are locked by
processes running locally.
lsacl Shows the access control list (ACL) associated with the files
and directories specified.
lty Lists the types currently installed on a volume.
mkapr Makes an Apollo product report.
obj2coff Converts SR9.5 or later object format modules to SR10 COFF
format modules. Either individual modules, or complete bound
programs may be converted.
prf Queues a file for printing.
rbak Restores objects from the backup input media written by wbak
(write_backup). The backup input media can be magnetic
media, file or standard input.
rwmt Reads tapes from non-Domain installations and writes tapes
that can be read by non-Domain installations. rwmt can read
and write u nlabeled tapes, as well as ANSI level 1-4 labeled
tapes.
scrattr Lists the X and Y dimensions of the display in pixels.
scrto Sets or displays the number of minutes the system waits
before it shuts off the display screen. It begins counting
minutes after the last input event or window configuration
change.
stcode Prints the text message associated with a hexadecimal status
code.
tb Prints a process traceback, listing the name and current line
number of each routine on the call stack.
tpm Allows you to define characteristics for the touchpad and
mouse.
tr_font Allows you to change the order in which characters appear in
fonts.
trty Tests whether some type supports a given trait. It prints a
message and returns a status that a shell can test
ts Displays the time stamp and module name stored in an object
module.
tz Sets the system time zone to a known time zone or to an
offset from Coordinate Universal Time (utc).
vsize Allows you to set the dimensions of the VT100 emulator window
pane. This command is valid only from within the VT100
emulator (which is invoked with the VT100 command);
attempting to use it directly from the shell causes an error.
vt100 Creates a window running the VT100 terminal emulator and
starts up a shell within the window.
wbak Writes one or more objects to either a removable media,
disk file or standard output.
xdmc Allows you to invoke Display Manager commands from the
command shell or from within a shell script.
Domain/OS SysV Extensions
This section describes Apollo extensions to standard UNIX commands.
ar Domain/OS SysV ar builds a module name table and a long name
table in addition to the symbol table; these tables are stored
in files that are never mentioned or accessible. This makes
ranlib obsolete.
cc cc is the Domain/OS SysV interface to the preprocessor (cpp),
the Domain C compiler, and the link editor (ld). The Domain/OS
SysV cc command provides some unique options; not all standard
UNIX options are available. The -A option identifies a unique
set of Domain/OS extensions to cc and ld.
cp The cp command includes a number of Domain/OS extensions. See
cp(1) for a complete description of these extensions.
csh limit -h resource maximum-use. You cannot use limit to set the
stack size, and the coredumpsize limit is always 0 in
Domain/OS. path. The default search path in Domain/OS SysV is
(. /usr/ucb /bin /usr/bin /usr/apollo/bin). However, this may
vary from system to system. For the super-user, the default
search path is (/etc /bin /usr/bin /usr/apollo/bin), which may
also vary.
ksh Domain/OS SysV includes support for the Korn shell and adds
some extensions to this shell. See "UNIX Shell Extensions",
below for a brief summary of the added features.
ld The Domain/OS SysV version of ld includes support for features
that are not available on System V Release 3. Domain/OS ld
supports the following extensions: static resource information
records (.sri), module information records (.mir), and control
of global variable visibility. The -A option identifies a
unique set of Domain/OS SysV extensions to cc and ld.
ln Symbolic links in Domain/OS are implemented as soft links.
These are identical in behavior, except that soft links to not
have protections associated with the links themselves.
login The login command is a merge of the System V and 4.3BSD login
commands. The -p argument causes the remainder of the
environment to be preserved, otherwise any previous environment
is discarded.
Domain/OS login includes new security features for dial-up
lines, /etc/d_users and /etc/d_passwd. /etc/d_users is simply
a file containing a list of users authorized to log in on this
node. /etc/d_passwd is a file containing lines which specify a
user's log-in shell, and the dial-in password for the specified
shell as returned by crypt(3). If an entry for the user's
log-in shell is not found in this file, the password for
/bin/sh is used.
lorder The need for lorder has vanished on Domain/OS systems, since
ar(1) and ld(1) cooperate to create randomly accessed
libraries.
ls If you specify -T with the -l option, it shows the Domain/OS
"type" of each file.
mkdir The mechanism for assigning the initial file ACL and initial
directory ACL for the directory created by the mkdir command
has been changed. The initial file ACL and initial directory
ACL are now inherited from the parent directory.
nm The -Ag option checks KGT (Known Global Table) to see if
undefined globals are defined in global libraries. If
specified with the -u option, nm will not print those undefined
symbols that are defined in global libraries.
passwd On Domain/OS systems, the /etc/passwd file is a typed file,
which is automatically generated by the registry daemon. The
registry administrator can make the person information in the
registry read-only, in which case normal users cannot change
the "Name" field.
ps The Domain/OS nodename option shows information about processes
running on the specified node.
ranlib ranlib is not necessary on Domain/OS SysV systems; however, it
is provided as a no-op for compatibility.
strip The -Aa option strips all debugging information, including that
needed for traceback. The .blocks and .lines sections, if
present, will be removed. This option strips more information
than the default strip behavior, and is added for users who
wish to remove all symbolic information.
tftp The Domain/OS SysV versions of tftp and tftpd(1M) are
adaptations of the MIT Project Athena implementations of the
tftp protocol. Domain/OS SysV tftp will interface with any
RFC783 compliant implementation.
uucp Domain/OS SysV supports "HoneyDanBer" uucp for both the SysV
and SysV environments. (See "UUCP Support" below).
who The who command includes a number of Domain/OS extensions.
UNIX Shell Extensions
Domain/OS includes support for the additional shell built-in commmands
inlib, rootnode, and ver.
rootnode causes / to refer to the node entry directory of //nodename
instead of the current node entry directory.
inlib installs a library at the current shell level; it remains installed
until the shell that installed it exits. The newly installed library will
be used to resolve external references of programs (and libraries) loaded
after its installation.
ver changes, temporarily or permanently, the UNIX version of commands
that are executed by the shell. The command also displays the version in
use.
csh and sh also include support for a new command line option,
-Dname=value. This option sets the parameter name to value, then passes
it to the shell's environment. This option is useful for tailoring the
environment of a shell invoked from a program that isn't a shell (such as
the Display Manager).
ksh has also been extended to support editing commands in Display Manager
pads. If the value of the variable EDITOR ends in emacs, gmacs, or vi
and the VISUAL is not set, the corresponding option is turned on. This
value should be unset for shells running in Apollo transcript pads.
For Apollo transcript pads, the variable FCEDIT should be set to 'pad'.
With dialup lines or in VT100 windows, values like vi or emacs are
useful.
The in-line editing options are not useful in Apollo transcript pads. The
command input pane associated with Transcript pads allows full command
line editing. Setting VISUAL or EDITOR in Apollo transcript pads causes
the pad to flip in and out of raw mode.
TCP/IP Support
At SR10, Domain/OS supports TCP/IP in the Aegis, BSD and SysV
environments. One version operates in all environments.
Unsupported Commands
The following commands from System V are not supported.
4014 bs ct
cw eqn ged
hpio ismpx jterm
jwin login mm
nroff sag sar
shl sysadm tbl
toc troff
At this revision nroff, troff, tbl, and associated text processing tools
are bundled and sold as a separate package for System V users.
SEE ALSO
intro(1), domain(1M), domain(7),
Using Your SysV Environment;
Managing SysV System Software.