DOMAIN(1) Domain/OS BSD DOMAIN(1)
NAME
domain - Domain/OS-specific commands and extensions
DESCRIPTION
While providing all of the significant functionality of 4.3BSD, Domain/OS
BSD actually represents only a subset of the greater functionality of
Domain/OS. Furthermore, Domain/OS BSD omits some features of 4.3BSD that
are irrelevant to Apollo(R) workstations. The following paragraphs
describe aspects of that greater functionality that are visible to the
Domain/OS BSD user and summarize features of 4.3BSD not implemented under
Domain/OS BSD.
Domain/OS Additions to the BSD Environment
Pages that describe the Domain/OS-specific commands are identified with
the page heading "Domain/OS BSD;" pages describing standard 4.3BSD
commands simply say "BSD".
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/OS extensions to the
UNIX environment. It also includes C include files for Domain/OS system
calls, as well as other added-value files.
The /usr/apollo/bin directory contains Domain/OS 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 file format for SR10.
cvtname Converts pathnames between uppercase and lowercase and
preserves 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 An interactive program that 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) command, part of
Domain/PAK (tm) (Domain Performance Analysis Kit), looks at
the performance of programs at the program counter (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. The iso commands include: 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 and display 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 Lists 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 unlabeled 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.
systype Displays the UNIX version stamp of the specified object file.
tb Prints a process traceback, listing the name and current line
number of each routine on the call stack.
tpm Allows you to define and display 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 BSD Extensions
This section describes Domain/OS extensions to standard UNIX commands.
ar Domain/OS BSD 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 interface to the preprocessor (cpp), the
Domain C compiler, and the link editor (ld). The Domain/OS 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.
coffdump coffdump is the Domain/OS implementation of an extended version
of the System V Release 3 dump command. Domain/OS does not
support the 4.3BSD dump comand.
cp The cp command includes a number of Domain/OS extensions. See
cp(1) for a complete description of these extensions.
dbx dbx creates a separate transcript pad for debugger interactions
unless you specify the -no_frame option. dbx also creates a
window to display source code unless you specify the -no_src
option.
df The nodename argument allows you to print the amount of free
disk space available on the specified node, nodename.
f77 f77 is the Domain/OS interface to the preprocessors, the Domain
FTN compiler, and the link editor (ld(1)). The Domain/OS BSD
f77 command provides some unique options; not all standard
4.3BSD options are available.
file The BSD environment uses the System V Release 3 version of the
file command.
ksh Domain/OS BSD supports the Korn shell and adds some extensions
to this shell. See "Extensions to the UNIX Shells," below, for
a brief summary of the added features; see ksh(1) for complete
information.
ld The Domain/OS version of ld includes support for features that
are not available on 4.3BSD. 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 BSD extensions to cc and ld.
login The /bin/login command is a merge of the System V and 4.3BSD
login commands. The environment can be expanded or modified by
supplying additional arguments to login, either at execution
time or when login requests your log-in name. Variables
containing = are placed in the environment without
modification.
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). See login(1) for more
information.
ln Symbolic links in Domain/OS are implemented as soft links.
These are identical in behavior, except that soft links do not
have protections associated with the links themselves.
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, ls 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 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 versions of tftp(1C) and tftpd(8C) are
adaptations of the MIT Project Athena implementations of the
tftp protocol. Domain/OS tftp will interface with any RFC783
compliant implementation.
uucp Domain/OS supports "HoneyDanBer" UUCP for both the BSD and
SysV environments. (See "UUCP Support" below).
who The who command includes a number of Domain/OS extensions. See
who(1) for a complete description of these extensions.
Extensions to the UNIX Shells
Domain/OS includes support in csh, ksh, and sh for the 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. This 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 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 dial-up 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.
UUCP Support
At SR10, Domain/OS supports only the System V HoneyDanBer version of UUCP
in both the BSD and SysV environments. The following BSD commands have
been replaced by their System V HoneyDanBer equivalents:
uucico(8C)
uuclean(8C)
uucp(1C)
uucpd(8C)
uulog(1C)
uuname(1C)
uupoll(8C)
uuq(1C)
uusend(1C)
uusnap(8C)
uux(1C)
uuxqt(8C)
The following HoneyDanBer UUCP commands have been added to the BSD
environment
uucheck(8C)
uucleanup(8C)
uusched(8C)
uustat(1C)
uuto(1C)
uux(1C)
Unsupported Commands
The following commands from 4.3BSD are not supported.
adb mset systat
as pc tc
crypt pdx tk
efl pi tn3270
fp pix tp
gcore pmerge vmstat
iostat px vwidth
learn pxp w
lisp pxref window
liszt sendbug xsend
lock symorder xget, enroll
lxref sysline
Manual pages describing specific features may point out other differences
and unsupported features. These descriptions usually appear in the
"NOTES" section.
NOTES
*VT100 is a registered trademark of Digital Equipment Corporation.
SEE ALSO
intro(1), domain(2), domain(3), domain(7), domain(8),
Using Your BSD Environment;
Managing BSD System Software.