O"07070101b1a081a403012c10b47809d02f01080pkginfo PSTAMP=SVR4.2 12/09/92
ARCH=386
PKG=man
VERSION=1
RELEASE=4.2
NAME=Online Manual
CATEGORY=system
VENDOR=UNIX System Laboratories
CLASSES=none
PREDEPEND=man
07070101468081a403012a8a873505b502f010230root.7/usr/share/man/man1/pchown.1 .if n .pH 1m/gen/pchown @(#)pchown 43.2 of 8/10/92
.\" Copyright 1989 AT&T
.TH pchown 1M
.SH NAME
\f4pchown\f1 \- change owner of mail files
.SH SYNOPSIS
.na
posixchown \-m \f2username\fP
.sp
posixchown \-m \f2:dirname\fP
.sp
posixchown \-s \f2username\fP
.sp
posixchown \-T
.sp
posixchown \-S [\f2dirname\fP]
.sp
posixchown \-a \f2alias.t\fP
.ad
.SH DESCRIPTION
\f4/usr/lib/mail/surrcmd/pchown\fP changes the owner and group of files
associated with the mail sytem.
It is only used by the mail program on systems in which the \f4chown\fP(2)
system call is restricted to privileged programs.
.P
The \-m option is used to either change the ownership and group of a user's file to
the given user and group \f4mail\fP, or, if the name starts with a colon,
the given directory name to user \f4root\fP and group \f4mail\fP.
.P
The \-s option is used to change the ownership and group of a user's
temporary file under \f4/var/mail/:saved\fP to the given user and group
\f4mail\fP.
.P
The \-T option changes the ownership and group of \f4/etc/mail/Tmailsurr\fP
to user \f4bin\fP and group \f4mail\fP.
.P
The \-S option is used to change \f4/var/spool/smtpq\fP or
\f4/var/spool/smtpq/\fP\f2dirname\fP to user \f4smtp\fP and group \f4mail\fP.
.P
The \-a option is used to change \f4/etc/mail/\fP\f2alias.t\fP to user
\f4bin\fP and group \f4mail\fP.
.P
This program is intended to be used from within the \f4mail\fP command.
.SH "SEE ALSO"
\f4mail\fP(1),
\f4chown\fP(2).
07070101469081a403012a8a8737095202f010260root.7/usr/share/man/man1/pciconsvr.1 .if n .pH 1pci/gen/pciconsvr @(#)pciconsvr 43.2 of 6/11/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pciconsvr 1 "PC-Interface"
.SH NAME
\f4pciconsvr.ip\fP \- manages the connection between the personal computer and the host
.SH SYNOPSIS
\f4/usr/pci/bin/pciconsvr\fP [\f4\-DFILNnTx\fP]
.SH DESCRIPTION
The \f4pciconsvr\fP daemon has two
jobs: to broadcast the message "pciconsvr \f2hostname\fP here" every 30
.IX "pciconsvr command"
seconds and to manage the connection between the personal computer
and the host.
The broadcast messages are used by the \f4pcimapsvr\fP daemon
to keep the list of available hosts up to date.
.IX "daemons, PC-Interface" "pciconsvr"
.IX "LAN" "network broadcast messages"
.P
The host connection process
.IX "host connection process" "over a LAN"
.IX "LAN" "host connection process"
includes several subordinate tasks.
The connection management
process begins when the \f4pciconsvr\fP daemon receives a connection request.
from LOGIN.
It assigns a port number for use in subsequent
communication with the personal computer and spawns a new
process, \f4/usr/pci/bin/pcidossvr.ip\fP.
.P
All of the options below can be set on the command line:
.IP \f4-D\fP
Specifies the debug level for the \f4pciconsvr.ip\fP daemon.
0 means no
debugging and \-Df means full debugging.
.IP \f4-F\fP
Specifies a feature file.
This file contains the feature
information used by the \f4pciconsvr\fP.
.IP \f4-I\fP
Is used to specify the interface list.
The interface list
consists of a local address, a broadcast address, and a subnet mask.
.IP
The syntax is:
.P
.RS 10
.ft 4
local,broadcast,subnet;local,broadcast,subnet; .
.ft
.RE
.IP
This is generated by \f4loadpci\fP.
Each address is specified in the
INTERNET standard format of A.B.C.D.
All components are numeric.
The exact format depends on the \f4inet_addr()\fP library function.
.ie \nB=1 .IX "commands, Access program" "pciconsvr"
.el .IX "commands, PC-Interface" "pciconsvr"
.IX "pciconsvr command"
.IP \f4-L\fP
Specifies the debug level for \f4pcidossvr.ip\fP.
.IP \f4-N\fP
Specifies the network device name.
.IP \f4-n\fP
Specifies the network descriptor to use.
This is an open file
descriptor that is passed from \f4loadpci\fP.
.IP \f4-T\fP
Specifies the "pciconsvr here" retransmission time.
.IP \f4-x\fP
Tells \f4pciconsvr.ip\fP not to disconnect \f4pcidossvr.ip\fP when
they time out.
0707010146a081a403012a8a87380ba402f010250root.7/usr/share/man/man1/pcidebug.1 .if n .pH 1pci/gen/pcidebug @(#)pcidebug 43.2 of 6/11/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pcidebug 1 "PC-Interface"
.SH NAME
\f4pcidebug\fP \- controls log output of the executing DOS server
.SH SYNOPSIS
\f4/usr/pci/bin/pcidebug\fP \f2pid\fP [[\f2op\fP] \f2channels\fP] [child] [on] [off] [close]
.SH DESCRIPTION
The \f4pcidebug\fP command controls log output of the
executing DOS server (\f4pcidossvr\fP) and monitors the bidirectional
.IX "pcidebug command"
communication between the personal computer and the host components of
\%PC-Interface.
.IX "PCIDEBUG command" "description of"
.IX "commands, PC-Interface" "PCIDEBUG"
.IX "application software, DOS" "networked"
It is also a mechanism for tracing the operations of the host component
in response to personal computer requests.
.P
There are 32 debugging output channels that can be controlled
independently from the command line when \f4pcidebug\fP is invoked.
Each channel controls the output of specific information
about the process being logged.
If a channel is activated, \f4pcidebug\fP outputs the data
associated with that channel. If a channel is not activated,
\f4pcidebug\fP does not output the data associated with that channel.
.P
\f4pcidebug\fP generates formatted debug output for all activated channels
and sends it to the host log file
\f4/usr/spool/pcilog/dossvr\fP.\f2pid\fP,
where \f2pid\fP is the process number of the executing server.
Output is generated only if at least one channel is enabled.
The debug channels that monitor a running server can be changed while
the server is running by invoking
\f4pcidebug\fP with the desired set of channels activated.
.P
The fields in the invocation are:
.RS 0
.IP \f2op\fP 0.6i
One of the following four symbols indicating the operation to be
done on the channels listed in the \f2channels\fP field:
.RS 0.6i
.IP \f4=\fP
Enable these channels.
.IP \f4+\fP
Add these channels to the enabled set.
.IP \f4\-\fP
Remove these channels from the enabled set.
.IP \f4\s+4\(ap\s0\fP
Toggle the state of these channels.
.RE
.IP \f2channels\fP 0.6i
A comma-separated list of integers between 1 and 32 representing
up to 32 channels.
1 refers to the least significant bit of the \f4dbgEnable\fP bit mask
and 32 refers to the most significant bit.
.IX "commands, PC-Interface" "pcidebug"
.IX "pcidebug command"
.P
The keyword arguments are:
.RS 0
.IP CHILD 0.6i
Manipulate the channels for the child processes, that is, for
\f4pcidossvrs\fP that are started from the \f4pciconsvr\fP.
.IP ON
Turn all channels on.
If this argument is given, a list of \f2channels\fP is redundant.
.IP OFF
Turn all channels off.
If this argument is given, a list of \f2channels\fP is redundant.
.IP CLOSE
Tell the server to close its log file.
This argument allows space used by the log file to be freed without
killing the server. CLOSE is typically invoked together with the
OFF argument to turn off all channels and
close the log file at the same time.
.RE
0707010146b081a403012a8a873a05502f010260root.7/usr/share/man/man1/pcidossvr.1 .if n .pH 1pci/gen/pcidossvr @(#)pcidossvr 43.2 of 6/11/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pcidossvr 1 "PC-Interface"
.IX "pcidossvr command"
.SH NAME
\f4pcidossvr\fP \- maintains an exclusive dialog with the bridge driver (BRIDGE.DRV) on the personal computer
.SH SYNOPSIS
\f4/usr/pci/bin/pcidossvr\fP [\f4\-D\fP]
.SH DESCRIPTION
The \f4pcidossvr\fP program (either \f4/usr/pci/bin/pcidossvr.ip\fP or
\f4/usr/pci/pcidossvr.232\fP) maintains an exclusive dialog with BRIDGE.DRV
on a personal computer.
.P
\f4pcidossvr\fP on the remote host translates
.IX "DOS system calls" "remote request"
.IX "system calls, DOS" "and BRIDGE.DRV support module"
.IX "BRIDGE.DRV support module" "and DOS system calls"
.IX "DOS system calls" "and BRIDGE.DRV support module"
.IX "DOS system calls" "local request"
.IX "system calls, DOS" "local request"
the user's standard DOS system calls into appropriate UNIX
operating system calls, executes them on behalf
of the user, translates the results back into standard DOS, and returns
the results to the user via BRIDGE.DRV.
The extension (\f4.ip\fP
or \f4.232\fP) identifies whether the connection is over a LAN or RS-232.
.P
The options can be entered from the command line. The \f4-D\fP option specifies
the debug level of \f4pcidossvr.ip\fP.
Other options may be generated by \f4pciconsvr.ip\fP.
0707010146c081a403012a8a873b050302f010260root.7/usr/share/man/man1/pcimapsvr.1 .if "n .pH 1pci/gen/pcimapsvr @(#)pcimapsvr 43.2 of 6/11/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pcimapsvr 1 "PC-Interface"
.SH NAME
\f4pcimapsvr.ip\fP \- listens for broadcasts from the connection server daemons.
.SH SYNOPSIS
\f4/usr/pci/bin/pcimapsvr\fP [\f4\-DINnS\fP]
.SH DESCRIPTION
The \f4pcimapsvr.ip\fP
daemon listens for broadcast requests
.IX "pcimapsvr command"
for site tables and for broadcasts from connection-server daemons
(\f4pciconsvr.ip\fP) announcing their presence.
.P
The following options can be entered at the command line:
.IP \f4-D\fP
Debug level of the \f4pcimapsvr.ip\fP.
.IP \f4-I\fP
Interface list, which
consists of a local address, a broadcast address, and a subnet mask.
The syntax is:
.P
.RS 10
.ft 4
local,broadcast,subnet;local,broadcast,subnet; .
.ft
.RE
.P
.IP
This is generated by \f4loadpci\fP. Each address is specified in the
Internet standard format of A.B.C.D. All components are numeric. The
exact format depends on the \f4inet_addr()\fP library function.
.IP \f4-N\fP
Network device name.
.IP \f4-n\fP
Network descriptor. This is an open file descriptor that is
passed from \f4loadpci\fP.
.IP \f4-S\fP
Use subnet masks when determining which servers to return
to the personal computer.
0707010146d081a403012a8a873c016902f010250root.7/usr/share/man/man1/pciprint.1 .if n .pH 1pci/gen/pciprint @(#)pciprint 43.2 of 6/11/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pciprint 1 "PC-Interface"
.SH NAME
\f4pciprint\fP \- sample print program
.SH SYNOPSIS
\f4/usr/pci/bin/pciprint\fP
.SH DESCRIPTION
The \f4pciprint\fP shell script is used as the default print
program for print jobs sent from the personal computer.
0707010146e081a403012a8a873e078602f010250root.7/usr/share/man/man1/pcistart.1 .if n .pH 1pci/gen/pcistart @(#)pcistart 43.2 of 6/11/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pcistart 1 "PC-Interface"
.SH NAME
\f4pcistart\fP \- starts the \%PC-Interface daemons on the host.
.SH SYNOPSIS
\f4/usr/pci/bin/pcistart\fP [debug]
.SH DESCRIPTION
A \f4pcistart\fP script is run when the system begins
multi-user mode. This sets environment parameters that affect all
.IX "pcistart command"
processes spawned by \f4pciconsvr\fP. Some of the items set are:
UMASK, TIME ZONE, default UNIX printer program, and the maximum file
size that can be translated between the host and personal computer.
.P
The default print program is defined in
\f4pcistart\fP. The default settings must be appropriate for your
system. You may want to change the default system printer to suit the
needs of your community.
.P
Changing the default system printer involves editing the \f4pcistart\fP
file and then stopping and restarting \%PC-Interface to make the change
effective. Be sure to warn \%PC-Interface users before you run
\f4pcistop\fP and \f4pcistart\fP. Editing \f4pcistart\fP is described in
Chapter 4.
.P
The script \f4/usr/pci/bin/pcistart\fP sets the \f4umask\fP when
.IX "umask" "changing"
.IX "variables, UNIX operating system" "umask"
\%PC-Interface is initialized.
This \f4umask\fP is inherited by the connection
server (\f4/usr/pci/bin/pciconsvr.ip\fP) and applies to all \%PC-Interface
LAN file service users. Refer to Chapter 4 for further
information.
.P
The option \f4debug\fP creates log files in \f4/usr/spool/pcilog\fP.
The three files are \f4mapsvr_log\fP, \f4consvr_log\fP, and
\f4loadpci_log\fP. These log files contain traces of bidirectional packet
information from the personal computer and the server.
The \f4debug\fP option
should only be used with the assistance of your vendor's technical
support personnel.
.IX "commands, PC-Interface" "pcistart"
.IX "pcistart command"
0707010146f081a403012a8a873f01e02f010240root.7/usr/share/man/man1/pcistop.1 .if n .pH 1pci/gen/pcistop @(#)pcistop 43.2 of 6/11/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pcistop 1 "PC-Interface"
.SH NAME
\f4pcistop\fP \- terminates \%PC-Interface execution on the host.
.SH SYNOPSIS
\f4/usr/pci/bin/pcistop\fP
.SH DESCRIPTION
\f4pcistop\fP kills \f4pciconsvr.ip\fP and
\f4pcimapsvr.ip\fP deamons and echoes that it has done so.
It does not stop RS-232
.IX "pcistop command"
processes.
.P
All \f4pcidossvr.ip\fP processes are also killed.
0707010147081a403012a8a874027502f010230root.7/usr/share/man/man1/pcnfsd.1 .if n .pH 1m/gen/pcnfsd @(#)pcnfsd 43.3 of 5/29/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pcnfsd 1M NFS
.SH NAME
\f4pcnfsd\f1 \- NFS daemon for PC\-NFS user authentication and remote printing
.SH SYNOPSIS
\f4/usr/lib/nfs/pcnfsd\f1
.SH DESCRIPTION
\f4pcnfsd\f1 starts the daemon that handles PC\-NFS user authentication and
remote printing from DOS client machines.
.P
This command has no options.
.P
The \f4pcnfsd\f1 daemon is automatically invoked in run level 3.
.P
Only a privileged user can execute this command.
.SH REFERENCES
\f4nfsping\f1(1M)
.P
See the documentation that comes with your PC\-NFS software.
07070101471081a403012a8a87420134602f010230root.7/usr/share/man/man1/pdiadd.1 .if n .pH 1m/386/pdiadd @(#)pdiadd 43.6 of 7/29/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pdiadd 1M
.SH NAME
\f4pdiadd\f1 \- add new disk, tape, or SCSI devices to the UNIX System kernel
.SH SYNOPSIS
\f4/etc/scsi/pdiadd\f1 [\f4\-d \f2dma_channel\f1] [\f4\-v \f2vector\f1] [\f4\-i \f2i/o_address\f1] [\f4\-m \f2memory_address\f1] [\f4\-R \f2ROOT\f1] \f2device\f1
.SH "DESCRIPTION"
This script, \f4pdiadd\fP,
adds support for a new disk, tape, or SCSI device
to the UNIX system kernel
by modifying the current system configuration in
\f4/etc/conf\f1.
After you run
this command, you need to reboot the machine.
A kernel reconfiguration will take place during this reboot.
Note that \f4pdiadd\f1 does not use the shell variable
\f4ROOT\f1
from the user environment as its starting path.
You may specify a value for \f4ROOT\f1 by
using the \f4\-R\fP option.
The \f4\-R\fP option should not be used
except for the special case of
kernel development in a non-root source tree.
.PP
Please note that if all you are trying to
do is add a new mass-storage
device to an existing, working disk controller or
SCSI host bus adapter
already installed in your UNIX System, you do
not need to use this command.
Simply shutdown your system, power it off, install
the new mass-storage device
and turn your system back on.
Any reconfiguration that
must take place to support your device will be automatic.
.PP
If the device you are adding is a disk device,
you also need to use the
\f4diskadd\fP(1M) utility to setup your new disk device
and create filesystems on it.
Do not attempt to run \f4diskadd\f1
until after you have shutdown and restarted your UNIX System.
.PP
If the device you are about to install
is or requires a new controller,
you must be able to
determine some of the basic characteristics
of your new controller.
If you do not understand
the terms DMA channel, interrupt vector,
and memory address, please read the documentation that
came with your new device carefully.
This should provide you with
enough data to successfully install your new
device in the UNIX System.
.SS "Options"
\f4pdiadd\fP takes the following options:
.IP "\f4\-d \f2dma_channel\f1"
Use this value instead of the default
DMA channel specified in the
\f4disk.cfg\fP file for the device you want to add.
\f2dma_channel\f1 should be an integer in the range
\f40\fP to \f47\fP on ISA-bus machines.
The value 0 here implies that the device
does not use a DMA channel.
This option is unnecessary on
Micro-Channel Architecture\(rg machines.
.IP "\f4\-v \f2vector\f1"
Use this value instead of the default
interrupt vector specified in the
\f4disk.cfg\fP file for the device you want to add.
\f2vector\f1 should be an integer in the range
\f40\fP to \f415\fP.
The value \f40\fP here implies that the device does
not use an interrupt vector.
.IP "\f4\-i \f2i/o_address\f1"
Use this value instead of the default
starting I/O address specified in the
\f4disk.cfg\fP file for the device you want to add.
\f2i/o_address\f1 should be a 3-digit hexadecimal
number on AT-bus machines, or
a 3- or 4-digit hexadecimal number
on Micro-Channel Architecture\(rg machines.
.IP "\f4\-m \f2memory_address\f1"
Use this value instead of the default starting
memory address specified in the
\f4disk.cfg\fP file for the device you want to add.
\f2memory_address\f1 should be a 5-digit hexadecimal
number on ISA-bus machines
and Micro-Channel Architecture\(rg machines.
The value \f40\fP here implies that the
device does not use a region of memory.
.IP "\f2device\f1"
This required argument specifies the new
controller you want to add.
For a list of the devices supported
by your release of the UNIX System,
simply execute \f4pdiadd\fP without any arguments
and a list will be displayed.
.SS "Return Values"
Because
\f4pdiadd\f1
cah#lls other system commands to perform system reconfiguration,
it reports all errors encountered by those commands,
then cleans up intermediate files created in the process.
In general, an exit value greater than \f40\fP
indicates an error was encountered by \f4pdiadd\f1.
An exit value of \f40\fP indicates success.
.SH "NOTES"
\f4pdiadd\fP is an administrative command and
must be run in single user mode.
See \f4init\fP(1M) for information on
switching the machine to single user mode.
.PP
Any configuration changes made with \f4pdiadd\fP
will not be
reflected in the output of \f4pdiconfig\fP(1M)
until the current UNIX System
kernel is rebuilt and the system is rebooted.
The UNIX System kernel
will be rebuilt automatically for you when you use the shutdown
command to reboot your system.
.PP
Because \f4pdiadd\fP does not support the large I/O addresses
required by EISA-bus controllers, you should install the
controller manually.
The manual installation procedure can be found in the
UNIX System administration documentation.
.SH "REFERENCES"
\f4disk.cfg\f1(4),
\f4diskadd\f1(1M),
\f4idbuild\f1(1M),
\f4idcheck\f1(1M),
\f4pdirm\f1(1M)
07070101472081a403012a8a87440a4e02f010260root.7/usr/share/man/man1/pdiconfig.1 .if n .pH 1m/386/pdiconfig @(#)pdiconfig 43.4 of 8/2/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.\"
.TH pdiconfig 1M
.SH NAME
\f4pdiconfig\fP \- determine which PDI disk, tape, and SCSI controllers are present
.SH SYNOPSIS
\f4/etc/scsi/pdiconfig\fP [\f4\-R\fP \f2ROOT\fP] [\f2filename\fP]
.SH "DESCRIPTION"
\f4pdiconfig\fP queries the Portable Device Interface (PDI) subsystem
to determine which disk, tape, and SCSI controllers are present.
\f4pdiconfig\fP reads the Equipped Device
Table (EDT) built by the PDI
drivers to determine which disk, tape,
and SCSI controllers are present.
This information is output in a format suitable
for piping directly to \f4diskcfg\fP.
.SS "Options"
\f4pdiconfig\fP accepts the following options:
.IP "\f4\-R\fP \f2ROOT\fP"
Uses this value instead of \f4\/\fP for the
root of a kernel source tree.
.IP "\f2filename\fP"
Directs output to \f2filename\fP instead of to standard output.
.SS "Output"
The output includes all of the information needed by \f4diskcfg\fP
to reconfigure the System files so that
a kernel can be built containing
only those drivers needed for devices
actually present on the system.
.PP
The format of the output for \f4pdiconfig\fP is:
.P
.RS
.nf
\f4driver name
long driver name
driver type
configure flag
unit number
dma channel 1
dma channel 2
ipl level
interrupt vector
interrupt sharing flag
starting I/O address
ending I/O address
starting memory address
ending memory address \f1
.fi
.RE
.PP
Each field has a value present and is tab separated.
If an error occurs while trying to retrieve the
EDT or configuration information, or if no devices are found in
the EDT, \f4pdiconfig\fP will terminate
with a non-zero return value.
.PP
Note that \f4pdiconfig\fP does not use the shell variable
\f2ROOT\fP
from the user's environment as its starting path.
You can specify a value for \f2ROOT\fP
by using the \f4\-R\fP option.
The \f4\-R\fP option should not be used
except for the special case of
kernel development in a non-root source tree.
.SS "Return Values"
\f4pdiconfig\fP
exits with a return code of zero on success and non-zero on failure.
.SH "NOTES"
\f4pdiconfig\fP is an administrative command and
must be run in single user mode.
See \f4init\fP(1M) for information on
switching the machine to single user mode.
.PP
Any loadable target drivers, such as
\f4st01\fP(7), \f4sc01\fP(7), or
\f4sw01\fP(7), that deal with PDI
devices, must be demand loaded
before executing \f4pdiconfig\f1.
See \f4modadmin\fP(1M) for
information on loading loadable drivers.
.SH "REFERENCES"
\f4disk.cfg\fP(4),
\f4diskcfg\fP(1M),
\f4init\fP(1M),
\f4pdiadd\fP(1M),
\f4pdirm\fP(1M)
07070101473081a403012a8a87450b8302f010250root.7/usr/share/man/man1/pdimkdev.1 .if n .pH 1m/386/pdimkdev @(#)pdimkdev 43.3 of 7/29/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.\"
.TH pdimkdev 1M
.SH NAME
\f4pdimkdev\fP \- generate device nodes for the
Portable Device Interface (PDI) sub\%system
.SH SYNOPSIS
\f4/etc/scsi/pdimkdev\fP [\f4\-fis\fP] [\f4\-d\fP \f2filename\fP]
.SH "DESCRIPTION"
\f4pdimkdev\fP reads the Equipped Device Table (EDT) built by the PDI
drivers and makes any device nodes needed for access to the
disk, tape, and SCSI controllers that are present on the system.
Since the device
nodes that are created for each device are unique to that
device type, template files are used to specify the device
naming conventions.
The location of the template files is
specified in a target controller index file, which may be
supplied as a command line argument.
By default, any time a
new device is detected, a message is printed on standard output
describing the device.
.PP
\f4pdimkdev\fP keeps a record of the EDT
from invocation to invocation
in \f4/etc/scsi/pdi_edt\fP.
If the EDT obtained by \f4pdimkdev\fP
during execution is identical to the one
in \f4/etc/scsi/pdi_edt\fP, no action is taken
and \f4pdimkdev\fP exits.
If the EDT has changed since the last
invocation, \f4pdimkdev\fP checks
every node for every device in the EDT
and creates any missing nodes.
.SS Options
\f4pdimkdev\fP takes the following options:
.IP "\f4\-f\fP"
Forces \f4pdimkdev\fP to run at a time other than
from \f4init\fP(1M).
\f4pdimkdev\fP is designed to be run from \f4init\fP;
to force its execution at any other time,
you must use the \f4\-f\fP option.
.IP "\f4\-i\fP"
Forces \f4pdimkdev\f1 to ignore the existing record
of this machine's
configuration in \f4/etc/scsi/pdi_edt\fP
and update all PDI device nodes,
as if a new device had been added to the system.
.IP "\f4\-s\fP"
Suppress the standard output message from \f4pdimkdev\fP
indicating that new device nodes were just created for a device.
.IP "\f4\-d\fP \f2filename\fP"
Use \f2filename\fP instead of \f4/etc/scsi/tc.index\fP
to determine which template file to use for each device.
.SS "Return Values"
\f4pdimkdev\fP
exits with a return code of zero
when it detects new devices on the
system.
If there are no new devices since the last time \f4pdimkdev\fP
was executed, it exits with a positive return code.
If an error is
detected, it exits with a negative return code.
.SS "Files"
.nf
\f4/etc/scsi/mkdev.d/*\fP,
\f4/etc/scsi/pdi_edt\fP,
\f4/etc/scsi/tc.index\fP
.fi
.SH "NOTES"
\f4pdimkdev\fP is an administrative command and
must be run in single user mode.
See \f4init\fP(1M) for information on
switching the machine to single user mode.
.PP
Any loadable target drivers, such as
\f4st01\fP(7), \f4sc01\fP(7), or
\f4sw01\fP(7), that deal with PDI
devices, must be demand loaded
before executing \f4pdimkdev\f1.
See \f4modadmin\fP(1M) for
information on loading loadable drivers.
.SH "REFERENCES"
\f4init\fP(1M)
\f4modadmin\fP(1M)
\f4pdimkdtab\fP(1M)
07070101474081a403012a8a87490bfd02f010260root.7/usr/share/man/man1/pdimkdtab.1 .if n .pH 1m/386/pdimkdtab @(#)pdimkdtab 43.2 of 7/17/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.\"
.TH pdimkdtab 1M
.SH NAME
\f4pdimkdtab\fP \- update the device table entries for the Portable Device Interface (PDI) subsystem
.SH SYNOPSIS
\f4/etc/scsi/pdimkdtab\fP [\f4\-fi\fP] [\f4\-d\fP \f2filename\fP]
.SH "DESCRIPTION"
\f4pdimkdtab\fP reads the Equipped Device Table
(EDT) built by the PDI
drivers and updates the device table entries
in \f4/etc/device.tab\fP
for any
disk, tape, and SCSI controllers that are present on the system.
Since the device table entries
that are created for each device are unique to that
device type, template files are used to specify the device
table entries.
The location of the template files is
specified in a target controller index file, which may be
supplied as a command line argument.
.PP
\f4pdimkdtab\fP keeps a record of the EDT
from invocation to invocation
in \f4/etc/scsi/pdi_edt\fP.
If the EDT obtained by \f4pdimkdtab\fP
during execution is identical to the one
in \f4/etc/scsi/pdi_edt\fP, no action is taken
and \f4pdimkdtab\fP exits.
If the EDT has changed since the last invocation
of either \f4pdimkdev\fP or
\f4pdimkdtab\fP, \f4pdimkdtab\fP updates the device table entries
for every device in the EDT.
.SS Options
\f4pdimkdtab\fP takes the following options:
.IP "\f4\-i\f1"
Forces \f4pdimkdtab to run at a time other than from
\f4init\fP(1M).
\f4pdimkdtab\fP is designed to be run from \f4init\fP; to
force its execution at any other time, you must use the
\f4\-f\fP option.
.IP "\f4\-i\f1"
Forces \f4pdimkdtab\f1 to ignore the existing record
of this machine's
configuration in \f4/etc/scsi/pdi_edt\fP
and update \f4/etc/device.tab\fP,
as if a new device had been added to the system.
.IP "\f4\-d\fP \f2filename\fP"
Use \f2filename\fP instead of \f4/etc/scsi/tc.index\fP
to determine which template file to use for each device.
.SS "Return Values"
\f4pdimkdtab\fP
exits with a return code of zero when
it detects new devices on the system.
If there are no new devices sin#ce the last time
either \f4pdimkdev\fP or \f4pdimkdtab\fP
were executed, it exits with a positive return code.
If an error is
detected, it exits with a negative return code.
.SS "NOTICES"
When \f4pdimkdtab\fP is run
immediately after \f4pdimkdev\fP,
it must be run with the \f4\-i\fP option
or no updates will take place, because the
EDT in \f4/etc/scsi/pdi_edt\fP will be the
one created by \f4pdimkdev\fP
and will be up to date.
.PP
\f4pdimkdtab\fP is an administrative command and
must be run in single user mode.
See \f4init\fP(1M) for information on
switching the machine to single user mode.
.PP
Any loadable target drivers, such as \f4st01\fP(7),
\f4sc01\fP(7), or \f4sw01\fP(7), which deal with PDI
devices, must be demand loaded before executing \f4pdimkdtab\fP.
See \f4modadmin\fP(1M) for information on loading loadable drivers.
.SS "Files"
.nf
\f4/etc/device.tab\fP
\f4/etc/scsi/mkdev.d/*\fP
\f4/etc/scsi/pdi_edt\fP
\f4/etc/scsi/tc.index\fP
.fi
.SH "REFERENCES"
\f4init\fP(1M),
\f4modadmin\fP(1M),
\f4pdimkdev\f1(1M)
07070101475081a403012a8a874a013eb02f010220root.7/usr/share/man/man1/pdirm.1 .if n .pH 1m/386/pdirm @(#)pdirm 43.6 of 7/29/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pdirm 1M
.SH NAME
\f4pdirm\f1 \- remove existing disk, tape, or SCSI devices from the UNIX System kernel
.SH SYNOPSIS
\f4/etc/scsi/pdirm\f1 [\f4-d \f2dma_channel\f1] [\f4\-v \f2vector\f1] [\f4-i \f2i/o_address\f1] [\f4-m \f2memory_address\f1] [\f4-R \f2ROOT\f1] \f2device \f1
.SH "DESCRIPTION"
This script, \f4pdirm\fP, removes support for a existing disk,
tape, or SCSI device from the
UNIX System kernel by modifying the current system configuration in
\f4/etc/conf\f1.
Once you run command, you need to reboot the machine.
A kernel reconfiguration will take place during this reboot.
Note that \f4pdirm\f1 does not use the shell variable
\f4ROOT\f1
from the user environment as its starting path.
You may specify a value for
the \f4ROOT\f1 variable using the \f4\-R\fP option.
The \f4\-R\fP option should not be used except
for the special case of
kernel development in a non-root source tree.
.PP
Please note that if all you are trying to do
is remove an existing mass-storage
device from an existing, working disk controller
or SCSI host bus adapter
already installed in your UNIX System, you
do not need to use this command.
Simply shutdown your system, power it off,
remove the mass-storage device
and turn your system back on.
Any reconfiguration that
must take place to support your device will be automatic.
.PP
If the device you are removing is a disk device,
make sure that none of
the critical parts of the UNIX System reside on it.
This will only be true if you specified
that the device be used during the
initial installation of the UNIX System on your machine.
.PP
If the device you are about to remove
is not an existing mass-storage device on a
disk controller or SCSI host bus adapter,
you must be able to determine the name
used by the UNIX System
to represent your controller or storage device
before you can remove it.
For a list of the devices supported
by your release of the UNIX System,
simply execute \f4pdirm\fP without any arguments and
a list will be displayed.
.SS Options
\f4pdirm\fP takes the following options:
.IP "\f4\-d \f2dma_channel\f1"
Use this value instead of the default
DMA channel specified in the
\f4disk.cfg\fP file for the device you want
to remove to uniquely identify the device.
\f2dma_channel\f1 should be an integer
in the range \f40\fP to \f47\fP on AT-bus machines.
The value \f40\fP here implies that the device
does not use a DMA channel.
This option is unnecessary on Micro-Channel
Architecture\(rg machines.
.IP "\f4\-v \f2vector\f1"
Use this value instead of the default interrupt
vector specified in the
\f4disk.cfg\fP file for the device you want
to remove to uniquely identify the device.
\f2vector\f1 should be an integer in the range
\f40\fP to \f415\fP.
The value \f40\fP here implies that the device
does not use an interrupt vector.
.IP "\f4\-i \f2i/o_address\f1"
Use this value instead of the default starting
I/O address specified in the
\f4disk.cfg\fP file for the device you
want to remove to uniquely identify the device.
\f2i/o_address\f1 should be a 3-digit hexadecimal
number on ISA-bus machines, or
a 3- or 4-digit hexadecimal number
on Micro-Channel \%Architecture\(rg machines.
.IP "\f4\-m \f2memory_address\f1"
Use this value instead of the default starting
memory address specified in the
\f4disk.cfg\fP file for the device you want to
remove to uniquely identify the device.
\f2memory_address\f1 should be a 5-digit hexadecimal number.
number on ISA-bus machines
and Micro-Channel Architecture\(rg machines.
The value \f40\fP here implies that the device
does not use a region of memory.
.IP "\f2device\f1"
This required argument specifies the new
controller you want to add.
For a list of the devices supported by
your release of the UNIX System,
simply execute \f4pdirm\fP without any arguments and
a list will be displayed.
If there is more than one instance of this
device installed on your system,
you may need to more explicitly identify the
correct device using one or
more of the command line options above.
However, this should be unnecessary
in most cases.
.SS "Return Values"
Because
\f4pdirm\f1
calls other system commands to perform the
system reconfiguration,
it reports all errors encountered by those commands,
then cleans up intermediate files created in the process.
In general, an exit value greater than \f40\fP indicates
an error was encountered by \f4pdirm\f1.
An exit value of \f40\fP indicates success.
.SH "NOTES"
\f4pdirm\fP is an administrative command and
must be run in single user mode.
See \f4init\fP(1M) for information on
switching the machine to single user mode.
.PP
Any configuration changes made with \f4pdirm\fP will not be
reflected in the output of \f4pdiconfig\fP(1M)
until the current UNIX System
kernel is rebuilt and the system is rebooted.
The UNIX System kernel
will be rebuilt automatically for you when you use the shutdown
command to reboot your system.
.SH "REFERENCES"
\f4disk.cfg\fP(4),
\f4diskadd\fP(1M),
\f4idbuild\fP(1M),
\f4idcheck\fP(1M),
\f4pdiadd\fP(1M)
07070101476081a403012a8a874b010ba02f010240root.7/usr/share/man/man1/pfb2pfa.1 .if n .pH 1/gen/pfb2pfa @(#)pfb2pfa 43.11 of 8/10/92
.\" Copyright 1992 UNIX System Laboratories, Inc.
.TH pfb2pfa 1
.tr ~
.SH NAME
\f4pfb2pfa\fP \- convert PostScript Type 1 outline fonts from binary to ASCII
.SH SYNOPSIS
\f4pfb2pfa\0<\fP \f2pfb-file\fP \&\f4\0>\fP \f2pfa-file\fP
.SH DESCRIPTION
The \f4pfb2pfa\fP utility converts Type 1 outline fonts
from their binary form to their ASCII form.
The binary form is usually the form
in which they appear on retail DOS diskettes;
the ASCII form is the form in which
they are stored on the system for use with X\s-1WIN\s0 and \f4lp\fP.
Both forms are encrypted.
.P
The utility takes no options and reads and writes
only standard input and output.
.SH USAGE
.P
.SS "Examples"
\f4pfb2pfa < HOBO.PFB > HOBO.PFA\fP
.SS "Installing Type 1 Fonts Using the UNIX Desktop"
The Font Setup application of the UNIX Desktop allows most Type 1 fonts
packaged for the retail DOS Windows\*R market to be installed using a
graphical user interface, via the Install selection of the Actions menu button.
This installation mechanism works for Type 1 fonts:
.RS
.IP "\-" 2
whose filenames have a suffix of \f4.PFB\fP, and
.IP "\-"
whose files are in the topmost directory of the diskette or in a
sub-directory named \f4PSFONTS\fP
.RE
.P
If a font has an associated AFM (Adobe Font Metrics) file,
the Font Setup installation process
also copies it to the system
(Type 1 fonts are installed in the directory \f4/usr/X/lib/fonts/type1\fP and
AFM files are installed in the \f4afm\fP subdirectory there).
.SS "Installing Type 1 Fonts Using UNIX Utilities"
If you have a Type 1 fonts diskette in DOS format that cannot be
installed using the graphical interface
(it would give you a message
like ``Diskette does not contain Type 1 fonts
in a recognizable format''),
the fonts can still be installed using a sequence of UNIX utilities.
Use the following steps:
.RS
.IP "1." 4
Open a terminal window (``xterm'') from the Applications folder.
.IP "2."
Ensure that the diskette can be read using the DOS diskette utilities.
Use the \f4dosdir\fP command:
.RS 10
\f4dosdir a: # use b: for second diskette drive\fP
.RE
.IP ""
If this displays a list of filenames in the format of a DOS \f4dir\fP
command, then the diskette is a DOS diskette.
.IP "3."
If any of the files shown in the output of the \f4dosdir\fP command are
directories (marked \f4
\fP in the output), then you need to repeat
the \f4dosdir\fP command with the directory name as part of the argument.
For example:
.RS 10
\f4dosdir a:/FONTS\fP
.RE
.IP ""
If at least one of the files shown from either of these \f4dosdir\fP
commands has a file name suffix of \f4.PFB\fP or \f4.PFA\fP, then
proceed; otherwise; the diskette has no usable Type 1 fonts.
.IP "4."
\f4su \- root\fP
.IP "5."
\f4cd /usr/h#X/lib/fonts/type1\fP
.IP "6."
For each \f4.PFB\fP file on the diskette, do the following sequence:
.RS 10
\f4doscp a:\f2filename\f4.PFB\0\0.\0\0\0\f1or \f4doscp a:/FONTS/\f2filename\f4.PFB\f1
.RE
.RS 10
\f4pfb2pfa\0<\0\f1\f2filename\f4.PFB\0>\f2\0filename\f4.pfa\f1
.RE
.RS 10
\f4rm\0\f2filename\f4.PFB\f1
.RE
.IP ""
If there are \f4.PFA\fP files on the diskette, those can be copied as well;
just skip the use of the \f4pfb2pfa\fP command to convert the file
(it is already in ASCII form) and the \f4rm\fP command.
.IP "7."
For each \f4.AFM\fP file on the diskette:
.RS 10
\f4doscp a:\f1\f2filename\f4.AFM\0afm\f1
.RE
This puts the font metric files in the appropriate directory.
.IP "8."
\f4LD_LIBRARY_PATH=/usr/X/lib mkfontscale && mkfontdir\fP
.IP "9."
\f4xset fp rehash\fP
.IP "10."
Use \f4exit\fP to return to your non-\f4root\fP login.
.RE
.P
Steps 8 and 9, which update the list of fonts available to the X server,
can also be accomplished using the Integrity Check selection on the
Actions menu button of the Font Setup client;
this method causes the \f4DERIVED_INSTANCE_PS\fP environment variable to
be used for the \f4mkfontscale\fP utility (it is set from the value in
the configuration file \f4/usr/X/defaults/Xwinfont\fP)
[see \f4mkfontscale\fP(1)].
.SH "SEE ALSO"
.na
\f4desktop\fP(1),
\f4download\fP(1),
\f4mkfontdir\fP(1),
\f4mkfontscale\fP(1)
.SH "NOTES"
Portions of this page are derived from material which is
copyright \(co 1987-1991 by Adobe Systems Incorporated.
07070101477081a403012a8a874f0d8302f010210root.7/usr/share/man/man1/pfmt.1 .if n .pH 1/gen/pfmt @(#)pfmt 43.3 of 8/8/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990 AT&T
.TH pfmt 1
.SH NAME
\f4pfmt\f1 \- display error message in standard format
.SH SYNOPSIS
.ft CW
.nf
pfmt [\-l \f2label\f4][\-s \f2severity\f4][\-g \f2catalog\f4:\f2msgid\f4] \f2format\f4 [\f2args\f4]
.ft 1
.fi
.SH DESCRIPTION
\f4pfmt\f1 uses \f2format\f1 for \f4printf\f1 style formatting of \f2args\f1.
\f4pfmt\f1 encapsulates the output in the standard error message format and
displays it on \f4stderr\f1.
.P
The following options are available.
.TP 12
\f4\-l \f2label\f1
Specify the label string to be displayed
with the message (for example, \f4"UX:cat"\f1).
\f2label\f1 is a character string no more than 25 characters in length;
it will be automatically suffixed with a colon (\f4:\f1).
When unspecified, no label is displayed as part of the message.
.TP 12
\f4\-s \f2severity\f1
Specify the severity string to be
displayed with the message.
Acceptable strings include the standard severities in either their print string
(that is, \f4HALT\f1, \f4ERROR\f1, \f4INFO\f1, \f4WARNING\f1, and
\f4"TO FIX"\f1) or keyword (that is, \f4halt\f1, \f4error\f1, \f4info\f1,
\f4warn\f1, and \f4action\f1) forms, or any other user-defined string.
A user-defined string will be assigned the integer severity value of 5.
The severity will be suffixed with a colon (\f4:\f1).
The \f4ERROR\f1 severity will be used if no severity is specified.
.TP 12
\f4\-g \f2catalog\f4:\f2msgid\f1
Specify that a
localized version of \f2format\f1 should be retrieved from a
locale-specific message database.
\f2catalog\f1 indicates the message database that
contains the localized version of the \f2format\f1 string.
\f2catalog\f1 must be limited to 14 characters.
These characters must be selected from a set of all characters values,
excluding \f4\\0\f1 (\f4NULL\f1) or the characters \f4/\f1 (slash) and
\f4:\f1 (colon).
.sp.5
\f2msgid\f1
is a positive number that indicates the index of the string
into the message database.
.sp.5
If \f2catalog\f1 does not exist in the current locale (identified by the
\f4LC_MESSAGES\f1 or \f4LANG\f1 environment variables),
or if \f2msgid\f1 is out of bounds,
\f4pfmt\f1 will attempt to retrieve the message from the C locale.
If this second retrieval fails, \f4pfmt\f1 uses the \f2format\f1
string as passed on the command line.
.sp.5
\f4pfmt\f1 will output
\f4Message not found!!\\n\f1 as the \f2format\f1 string
if \f2msgid\f1 is not a valid number.
.SS "Standard Error Message Format"
\f4pfmt\f1 displays error messages in the following format:
.P
.RS
\f2label\f4: \f2severity\f4: \f2text\f1
.RE
.P
If no \f2label\f1 was defined using the \f4-l \f2label\f1 option, the message
is displayed in the format:
.sp .5
\f2severity\f4: \f2text\f1
.br
.ne 4
.P
If \f4pfmt\f1 is called twice to display an
error message and a helpful \f2action\f1 or recovery message,
the output can look like the following:
.P
.RS
\f2label\f4: \f2severity\f4: \f2text\f1
.br
\f2label\f4: TO FIX: \f2text\f1
.RE
.SH EXAMPLE
Example 1:
.P
.RS
.ft 4
.nf
pfmt \-l UX:test \-s error "Syntax error\\n"
.ft 1
.fi
.RE
.P
displays the message:
.P
.RS
.ft 4
.nf
UX:test: ERROR: Syntax error
.ft 1
.fi
.RE
.SH SEE ALSO
.na
\f4gettxt\fP(1),
\f4printf\fP(1),
\f4pfmt\fP(3C),
\f4environ\fP(5)
.ad
.SH DIAGNOSTICS
Upon success, \f4pfmt\f1 exits with code 0.
.P
Upon failure, \f4pfmt\f1 exits with the following codes:
.TP
1
write error
.TP
3
syntax error
07070101478081a403012a8a875c0b7102f010210root.7/usr/share/man/man1/ping.1 .if n .pH 1m/gen/ping @(#)ping 43.5 of 6/30/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH ping 1M
.UC 6
.SH NAME
\f4ping\f1 \- send \s-1ICMP\s0 \f4ECHO_REQUEST\f1 packets to network hosts
.SH SYNOPSIS
\f4/usr/sbin/ping \f2host\fP [\f2timeout\fP]
.P
\f4/usr/sbin/ping \-s [\-drvRl] \f2host\fP [\f2data size\fP] [\f2npackets\fP]
.SH DESCRIPTION
.P
\f4ping\f1
utilizes the
.SM ICMP
protocol's
\f4ECHO_REQUEST\f1
datagram to elicit an
.SM ICMP
\f4ECHO_RESPONSE\f1
from the specified
\f2host\f1 or network gateway.
If
.I host
responds,
\f4ping\f1
will print
\f2host \f4is alive\f1
on the standard output and exit. Otherwise after
.I timeout
seconds, it will write
\f4no answer from \f2host\f1.
The default value of
.I timeout
is 20 seconds.
.P
When the
\f4\-s\f1
flag is specified,
\f4ping\f1
sends one datagram per second, and
prints one line of output for every
\f4ECHO_RESPONSE\f1
that it receives. No output is produced if there is no response.
In this second form,
\f4ping\f1
computes round trip times and packet loss statistics;
it displays a summary of this information upon termination or timeout.
The default datagram packet size is 64 bytes, or you can specify
a size with the
.I datasize
command-line argument. If an optional
.I npackets
is given,
\f4ping\f1
sends only that number of requests.
.P
When using
\f4ping\f1
for fault isolation, first
ping
the local host to verify that the local network interface is running.
.P
.SH OPTIONS
.TP
\f4\-d\f1
Debug mode.
Prints the \f2ping\f1 statistics to "standard output" (\f4stdout\f1).
The \f4\-d\f1 option can be used with \f2datasize\f1 and/or \f2npackets\f1.
If \f2npackets\f1 is not specified, the command will execute indefinitely.
Use the BREAK key to interrupt the continuous output.
.TP
\f4\-l\f1
Loose source route. Use this option in the
.SM IP
header to send the packet to the given host and back again.
Usually specified with the
\f4\-R\f1
option. The \f4\-l\f1 option is only valid when the \f2host\f1 is \f4localhost\f1 or \f4\`uname \-n\`\f1.
.TP
\f4\-r\f1
Bypass the normal routing tables and send directly to a host on an
attached network. If the host is not on a directly-attached network,
an error is returned.
This option can be used to
\f4ping\f1
a local host through an interface that has been dropped by the
router daemon [see
\f4routed\f1(1M)].
.TP
\f4\-R\f1
Record route.
Sets the
.SM IP
record route option, which will store the route
of the packet inside the
.SM IP
header. The contents of the record route
will only be printed if the
\f4\-v \f1
option is given, and only be set on return packets if the target host
preserves the record route option across echos, or the
\f4\-l\f1
option is given.
.TP
\f4\-v\f1
Verbose output. List any
.SM ICMP
packets, other than
\f4ECHO_RESPONSE\f1,
that are received.
.SH SEE ALSO
\f4icmp\f1(7),
\f4ifconfig\f1(1M),
\f4netstat\f1(1M),
\f4rpcinfo\f1(1M)
07070101479081a403012a8a8761014ac02f010230root.7/usr/share/man/man1/pkgask.1 .if n .pH 1m/gen/pkgask @(#)pkgask 43.7 of 7/31/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pkgask 1M
.SH NAME
\f4pkgask\f1 \- stores answers to a request script
.SH SYNOPSIS
\f4pkgask \f1[\f4-d \f2device\f1] \f4-r \f2response\f1
[\f2pkginst\f1 [\f2pkginst\f1 [ . . . ]\|]
.SH DESCRIPTION
\f4pkgask\f1 allows an administrator
to store answers to an interactive package
(one with a request script) or a set of packages.
A set is made up of a special-purpose package,
referred to as a Set Installation Package (SIP),
and a collection of one or more packages that are members of the set.
The SIP controls the installation of the set.
.P
Invoking \f4pkgask\fP generates a \f2response\f1 file that is
then used as input
at installation time.
The use of
this \f2response\f1 file prevents any interaction
from occurring during installation since the file# already contains all
of the information the package needs.
.TP 13
\f4\-d \f2device\f1
Runs the request script for a package on \f2device\f1.
\f2device\f1 can be
(a) the full pathname to a directory
(such as \f4/var/tmp\f1),
(b) the full pathname to a device
(such as \f4/dev/rmt/*\f1 or \f4/dev/dsk/*\f1)
[see \f4intro\fP(7)],
or (c) a device alias.
The default device is the installation spool directory
(\f4/var/spool/pkg\fP).
.IP
An alias is the unique name by which a device is known.
(For example, the alias for a cartridge tape drive
might be \f4ctape1\f1.)
The name must be limited in length to 64 characters
(\f4DDB_MAXALIAS\f1)
and may contain only alphanumeric characters
and/or any of the following special characters:
underscore (\f4_\f1), dollar sign (\f4$\f1),
hyphen (\f4-\f1), and period (\f4.\f1).
No two devices in the database
may share the same alias.
.TP 13
\f4\-r \f2response\f1
Identifies a file or directory,
\f2response\fP,
which should be created to contain the responses
to interactions with the package.
The file,
or directory of files,
can later be used as input to the \f4pkgadd\f1 command
[see \f4pkgadd\fP(1M)].
When \f2pkginst\fP is a package, \f2response\f1 can be a full pathname
or a directory;
when \f2pkginst\fP is a SIP, \f2response\f1 must be a directory.
For a complete description of
request scripts and response files,
see your system administration or software packaging guides.
.TP 13
\f2pkginst\f1
A short string used to designate a package/set.
It is composed of one or two parts:
\f2pkg\fP (an abbreviation for the package/set name)
or, if more than one instance of that package exists,
\f2pkg\fP plus \f2inst\fP (an instance identifier).
(The term ``package instance'' is used loosely: it
refers to all instantiations of \f2pkginst\fP,
even those that do not include instance identifiers.)
.IP
The package name abbreviation (\f2pkg\fP)
is the mandatory part of \f2pkginst\fP.
To create such an abbreviation,
assign it with the \f4PKG\fP parameter.
For example, to assign the abbreviation \f4cmds\fP
to the Advanced Commands package,
enter \f4PKG=cmds\fP.
.IP
If \f2pkginst\f1 specifies a SIP,
all request scripts for packages which are members of that set are run (if any)
and the resulting response files are placed in the directory
provided to the \f4-r\f1 option.
.IP
The second part (\f2inst\fP),
which is required only if you have
more than one instance of the package in question,
is a suffix that identifies the instance.
This suffix is either a number (preceded by a period)
or any short mnemonic string you choose.
If you don't assign your own instance identifier
when one is required,
the system assigns a numeric one by default.
For example, if you have three instances
of the Advanced Commands package
and you don't create your own mnemonic identifiers
(such as \f4old\fP and \f4beta\fP),
the system adds the suffixes \f4.2\fP and \f4.3\fP
to the second and third packages, automatically.
.IP
To indicate all instances of a package, specify
\f4'\f2pkginst\f4.\(**'\f1,
enclosing the command line in single quotes, as shown,
to prevent the shell from interpreting the \(** character.
Use the token \f4all\f1
to refer to all packages available on the source medium.
.SH NOTES
You can use the \f4-r\f1 option
to indicate a directory name as well as a filename.
The directory name is used to create
numerous \f2response\f1 files,
each sharing the name of the package with which
it should be associated.
This is useful, for example,
when you add multiple interactive packages
with one invocation of \f4pkgadd\f1.
Each package needs a \f2response\f1 file.
To create multiple response files
with the same name as the package instance,
name the directory in which the files should be created and supply multiple
instance names with the \f4pkgask\f1 command.
When installing the packages,
you can identify this directory to
the \f4pkgadd\f1 command.
.SH FILES
.TP 30
\f4/var/spool/pkg\fP
default spool directory
.SH SEE ALSO
.na
\f4compver\fP(4),
\f4copyright\fP(4),
\f4depend\fP(4),
\f4installf\fP(1M),
\f4intro\fP(7),
\f4pkgadd\fP(1M),
\f4pkgchk\fP(1M),
\f4pkginfo\fP(1),
\f4pkginfo\fP(4),
\f4pkgmap\fP(4),
\f4pkgmk\fP(1),
\f4pkgparam\fP(1),
\f4pkgproto\fP(1),
\f4pkgtrans\fP(1),
\f4pkgrm\fP(1M),
\f4removef\fP(1M),
\f4setinfo\fP(4),
\f4space\fP(4)
.ad
.sp 0.4
.BT "UNIX Software Development Tools"
.sp 0.4
.BT "Basic System Administration"
0707010147a081a403012a8a87630168c02f010230root.7/usr/share/man/man1/pkgchk.1 .if n .pH 1m/gen/pkgchk @(#)pkgchk 43.5 of 7/31/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pkgchk 1M
.SH NAME
\f4pkgchk\f1 \- check accuracy of installation
.SH SYNOPSIS
.na
.ds [ \f1[\fP
.ds ] \f1]\fP
.ds | \f1\||\fP
.ft 4
pkgchk \*[-l\*|-acfqv\*] \*[-nx\*] \*[-p \f2path1\fP\*[,\f2path2\fP \f1. . .\fP\*] \*[-i \f2file\fP\*] \*[\f2pkginst\f1 . . . \fP\*]
.sp .5
.ft 4
pkgchk \-d \f2device\fP \*[-l\*|v\*] \*[-p \f2path1\fP\*[,\f2path2\fP \f1. . .\fP\*] \*[-i \f2file\fP\*] \*[\f2pkginst\fP\f1 . . . \fP\*]
.sp .5
.ft 4
pkgchk \-m \f2pkgmap\fP \*[-e \f2envfile\fP\*] \*[-l\*|-acfqv\*] \*[-nx\*] \*[-i \f2file\fP\*] \*[-p \f2path1\fP\*[,\f2path2\fP \f1. . . \fP\*]\*]
.ft 1
.ad
.SH DESCRIPTION
\f4pkgchk\f1
checks the accuracy of installed files or,
by use of the \f4\-l\f1 option,
displays information about package files.
The command checks the integrity of directory structures and the files.
Discrepancies are reported
on \f4stderr\f1 along with a detailed explanation of the problem.
.PP
The first synopsis defined above is used to list or check the
contents and/or attributes of objects
that are currently installed on the system.
Package names may be listed on the command line,
or by default the entire contents of a machine will be checked.
.PP
The second synopsis is used to list or check the contents of a package
which has been spooled on the specified device, but not installed.
Note that attributes cannot be checked for spooled packages.
.PP
The third synopsis is used to list or check the contents and/or attributes
of objects which are described in the indicated \f2pkgmap\f1.
.PP
The option definitions are:
.TP .5i
\f4\-l\f1
Lists information on the selected files that make up a package.
It is not compatible with the \f4a\f1,
\f4c\f1,
\f4f\f1,
\f4g\f1,
and \f4v\f1 options.
.TP
\f4\-a\f1
Audits the file attributes only, does not check file contents.
Default is to check both.
.TP
\f4\-c\f1
Audits the file contents only, does not check file attributes.
Default is to check both.
.TP
\f4\-f\f1
Corrects file attributes if possible.
If used with the \f4-x\fP option,
it removes hidden files.
When \f4pkgchk\f1 is invoked with this option it creates directories, named
pipes, links, and special devices if they do not already exist.
.TP
\f4-q\f1
Quiet mode.
Does not give messages about missing files.
.TP
\f4-v\f1
Verbose mode.
Files are listed as processed.
.TP
\f4-n\f1
Does not check volatile files.
This should be used for most post-installation checking.
.TP
\f4-x\f1
Searches exclusive directories only,
looking for files that exist that are not
in the installation software database
or the indicated \f2pkgmap\f1 file.
(An exclusive directory is a directory
created by and for a package; it should contain
only files delivered with a package.
If any non-package files
are found in an exclusive directory,
\f4pkgchk\fP reports an error.)
If \f4-x\fP is used with the \f4-f\fP option,
hidden files are removed;
no other checking is done.
.TP
\f4-p\f1
Only checks the accuracy of the pathname or pathnames listed.
\f2pathname\f1
can be one or more pathnames separated by commas (or by white space, if
the list is quoted).
.TP
\f4-i\f1
Reads a list of pathnames from \f2file\f1 and compares this list against the
in\%stallation software database
or the indicated \f2pkgmap\f1 file.
Pathnames that are not contained in \f2inputfile\f1 are not checked.
.TP
\f4\-d\f1
Specifies the device on which a spooled package resides.
\f2device\f1 can be a directory pathname or
the identifiers for a tape or other removable medium
(for example, \f4/var/tmp\f1 or \f4/dev/rmt/ctape1\f1).
.TP
\f4\-m\f1
Requests that the package be checked against the pkgmap file \f2pkgmap\f1.
.TP
\f4\-e\f1
Requests that the pkginfo file named as \f2envfile\f1 be used to resolve
parameters noted in the specified pkgmap file.
.TP
\f2pkginst\f1
A short string used to designate a package.
It is composed of one or two parts:
\f2pkg\fP (an abbreviation for the package name)
or, if more than one instance of that package exists,
\f2pkg\fP plus \f2inst\fP (an instance identifier).
(The term ``package instance'' is used loosely: it
refers to all instantiations of \f2pkginst\fP,
even those that do not include instance identifiers.)
.IP
The package name abbreviation (\f2pkg\fP)
is the mandatory part of \f2pkginst\fP.
[See \f4pkginfo\fP(1), \f4pkginfo\fP(4).]
.IP
The second part (\f2inst\fP),
which is required only if you have
more than one instance of the package in question,
is a suffix that identifies the instance.
This suffix is either a number (preceded by a period)
or any short mnemonic string you choose.
If you don'#t assign your own instance identifier
when one is required,
the system assigns a numeric one by default.
For example, if you have three instances
of the Advanced Commands package
and you don't create your own mnemonic identifiers
(such as \f4old\fP and \f4beta\fP),
the system adds the suffixes \f4.2\fP and \f4.3\fP
to the second and third packages, automatically.
.IP
To indicate all instances of a package, specify
\f4'\f2pkginst\f4.\(**'\f1,
enclosing the command line in single quotes, as shown,
to prevent the shell from interpreting the \(** character.
Use the token \f4all\f1
to refer to all packages available on the source medium.
.SH NOTES
To remove hidden files only,
use the \f4-f\fP and \f4-x\fP options together.
To remove hidden files and check attributes
and contents of files,
use the \f4-f\fP, \f4-x\fP, \f4-c\fP,
and \f4-a\fP options together.
.SH SEE ALSO
.na
\f4compver\fP(4),
\f4copyright\fP(4),
\f4depend\fP(4),
\f4installf\fP(1M),
\f4pkgadd\f1(1M),
\f4pkgask\f1(1M),
\f4pkginfo\f1(1),
\f4pkginfo\f1(4),
\f4pkgmap\fP(4),
\f4pkgrm\f1(1M),
\f4pkgtrans\f1(1),
\f4space\fP(4)
.ad
0707010147b081a403012a8a876701c9602f010240root.7/usr/share/man/man1/pkginfo.1 .if n .pH 1/gen/pkginfo @(#)pkginfo 43.12 of 7/31/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pkginfo 1
.SH NAME
\f4pkginfo\f1 \- display software package and/or set information
.SH SYNOPSIS
.ta .5i
.nf
\f4pkginfo \f1[\f4-q\f1] [\f4x\f1\ |\f4l\f1] [\f4-p\f1\ |\f4i\f1] [\f4-a \f2arch\f1] [\f4-v \f2version\f1]
.br
[\f4-c \f2category1\f4,\f1[\f2category2\f1[\f4,\f1 . . . ]\|]\|] [\f2pkginst\f1[\f4,\f2pkginst\f1[\f4,\f1 . . . ]\|]\|]
.sp .5
\f4pkginfo\f1 [\f4-d \f2device\f1 [\f4-q\f1] [\f4x\f1\ |\f4l\f1] [\f4-a \f2arch\f1] [\f4-v \f2version\f1]
.br
[\f4-c \f2category1\f4,\f1[\f2category2\f1[\f4,\f1 . . . ]\|]\|] [\f2pkginst\f1[\f4,\f2pkginst\f1[\f4,\f1 . . . ]\|]\|]
.fi
.SH DESCRIPTION
\f4pkginfo\f1
displays information about software packages or sets
that are installed on the system
(as requested in the first synopsis)
or that reside on a particular device or directory
(as requested in the second synopsis).
A package is a collection of related files and executables that can be
independently installed.
A set is made up of a special-purpose package,
referred to as a Set Installation Package (SIP),
and a collection of one or more packages that are members of the set.
The SIP controls the \%installation of the set.
.PP
When run without options,
\f4pkginfo\fP displays one line of information about
every installed package
(whether installed completely or partially) whose category is not the value
``set.''
The information displayed includes
the primary category, package instance,
and name of the package.
For UNIX software packages produced before UNIX System V Release 4,
\f4pkginfo\fP displays
only the package name and abbreviation.
For XENIX software packages,
\f4pkginfo\fP prints the heading ``Custom Installed Packages,''
followed by a list of XENIX packages.
The list identifies the package name and abbreviation,
with the word \f4yes\fP in place of the package instance,
to indicate that the package is installed.
.PP
The \f4-p\fP and \f4-i\fP options
are meaningless if used in conjunction with the \f4-d\fP option.
The \f4-p\fP and \f4-i\fP options are mutually exclusive.
The \f4-x\fP and \f4-l\fP options are mutually exclusive.
.PP
The options for this command are:
.TP 10
\f4-q\f1
Do not list any information.
This option overrides the
\f4-x\f4,
\f4-l\f4,
\f4-p\f4,
and
\f4-i\f4
options.
(Can be invoked by a program to query
whether or not a package has been installed.)
.TP 10
\f4-x\f1
Extract and display the following information
about the specified package: abbreviation, name,
and, if available, architecture and version.
.TP 10
\f4-l\f1
Display a ``long format'' report
(that is, one that includes all available information)
about the specified package(s).
.TP 10
\f4-p\f1
Display information only for partially installed
packages.
.TP 10
\f4-i\f1
Display information only for fully installed packages.
.TP 10
\f4-a \f2arch\f1
Specify the architecture of the package as \f2arch\f1.
.TP 10
\f4-v \f2version\f1
Specify the version of the package as \f2version\f1.
All compatible versions can be requested by
preceding the version name with a tilde (\f4~\fP).
The list produced by \f4-v\fP will include
pre-Release 4 and XENIX software packages
(with which no version numbers are associated).
Multiple white spaces are replaced with a single space
during version comparison.
.TP 10
\f4-c \f2category\f1 . . .
Display information about packages that belong to
category \f2category\f1.
(Categories are defined in the category field of
the \f4pkginfo\fP file; see \f4pkginfo\fP(4) for details.)
More than one category may be specified
(as long as they're separated by white space).
A package is required to belong to
only one category,
even when multiple categories are specified.
The package-to-category match is case-specific.
.IP
If the category specified is ``set,'' \f4pkginfo\fP
will display information about Set Installation Packages (SIPs).
.TP 10
\f2pkginst\f1
A short string used to designate a package/set.
It is composed of one or two parts:
\f2pkg\fP (an abbreviation for the package/set name)
or, if more than one instance of that package exists,
\f2pkg\fP plus \f2inst\fP (an instance identifier).
(The term ``package instance'' is used loosely: it
refers to all instantiations of \f2pkginst\fP,
even those that do not include instance identifiers.)
.IP
The package name abbreviation (\f2pkg\fP)
is the mandatory part of \f2pkginst\fP.
[See \f4pkginfo\fP(4).]
.IP
The second part (\f2inst\fP),
which is required only if you have
more than one instance of the package in question,
is a suffix that identifies the instance.
This suffix is either a number (preceded by a period)
or any short mnemonic string you choose.
If you don't assign your own instance identifier
when one is required,
the system assigns a numeric one by default.
For example, if you have three instances
of the Advanced Commands package
and you don't create your own mnemonic identifiers
(such as \f4old\fP and \f4beta\fP),
the system adds the suffixes \f4.2\fP and \f4.3\fP
to the second and third packages, automatically.
.IP
To indicate all instances of a package, specify
\f4'\f2pkginst\f4.\(**'\f1,
enclosing the command line in single quotes, as shown,
to prevent the shell from interpreting the \(** character.
Use the token \f4all\f1
to refer to all packages available on the source medium.
.IP
If \f2pkginst\f1 is a SIP, information about the packages
with which the SIP is associated will be displayed.
.TP 10
\f4-d \f2device\f1
Display information from packages/sets that reside on \f2device\fP.
\f2device\f1 can be
(a) the full pathname to a directory
(such as \f4/var/tmp\f1),
(b) the full pathname to a device
(such as \f4/dev/rmt/*\f1 or \f4/dev/dsk/*\f1)
[see \f4intro\fP(7)],
or (c) a device alias.
The default device is the installation spool directory
(\f4/var/spool/pkg\fP).
.IP
An alias is the unique name by which a device is known.
(For example, the alias for a cartridge tape drive
might be \f4ctape1\f1.)
The name must be limited in length to 64 characters
(\f4DDB_MAXALIAS\f1)
and may contain only alphanumeric characters
and/or any of the following special characters:
underscore (\f4_\f1), dollar sign (\f4$\f1),
hyphen (\f4-\f1), and period (\f4.\f1).
No two devices in the database
may share the same alias.
.SH NOTES
\f4pkginfo\f1 cannot tell if
a pre-UNIX System V Release 4 or XENIX software package
is only partially installed.
It is assumed that all
pre-Release 4 and XENIX software packages are fully installed.
.P
If \f4pkginfo\f1 is invoked to obtain information on packages that are
members of sets located on tape media,
all options to \f4pkginfo\f1 are allowed since the information on
these packages is readily available on the tape.
In the case of diskettes, if the SIP and each of its member packages are on
separate disks, not all information on these packages is available.
In this case, the \f4pkginfo\f1 command will only display a short listing.
For this reason, the \f4\-a\f1, \f4\-l\f1 and \f4\-v\f1 options will not
work for sets whose packages span over several diskettes.
.SH FILES
.TP 30
\f4/var/spool/pkg\fP
default spool directory
.SH SEE ALSO
.na
\f4intro\fP(7),
\f4pkgadd\fP(1M),
\f4pkgask\fP(1M),
\f4pkgchk\fP(1M),
\f4pkginfo\fP(4),
\f4pkgrm\fP(1M),
\f4pkgtrans\fP(1),
\f4setinfo\fP(4)
.ad
0707010147c081a403012a8a87690e402f010220root.7/usr/share/man/man1/pkgmk.1 .if n .pH 1/gen/pkgmk @(#)pkgmk 43.9 of 8/6/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pkgmk 1
.SH NAME
\f4pkgmk\f1 \- produce an installable package
.SH SYNOPSIS
\f4pkgmk \f1[\f4-o\f1] [\f4\-c\f1] [\f4-d \f2device\f1] [\f4-r \f2rootpath\f1] [\f4-b \f2basedir\f1] [\f4-l \f2limit\f1]
\f1[\f4-a \f2arch\f1]
.br
[\f4-v \f2version\f1] [\f4-p \f2pstamp\f1] [\f4-f \f2prototype\f1]
[\f2variable=value\f1 . . . ] [\f2pkginst\f1]
.SH DESCRIPTION
\f4pkgmk\f1
pr#oduces an installable package to be used as input to the \f4pkgadd\f1
command.
The package contents will be in directory structure format.
A package is a collection of related files and executables that can be
independently installed.
.PP
The command uses the package \f4prototype\fP file as input
and creates a \f4pkgmap\fP
file.
The contents for each entry in the \f4prototype\fP file is copied to the
appropriate output location.
Information concerning the contents (checksum,
file size, modification date) is computed and stored in the \f4pkgmap\fP file,
along with attribute information specified in the \f4prototype\fP file.
.TP 15
\f4-o\f1
Overwrites the same instance,
package instance will be overwritten if it already exists.
.TP 15
\f4-c\f1
Compresses non-information files.
.TP 15
\f4-d \f2device\f1
Creates the package on \f2device\f1.
\f2device\f1 can be a
full pathname to a directory or the identifier
for a removable block device
(for example, \f4diskette1\fP).
The default device is the installation spool directory.
.TP 15
\f4-r \f2rootpath\f1
Uses the indicated \f2rootpath\f1 with the source
pathname in the \f4prototype\fP file appended to locate objects on the source machine.
.TP 15
\f4-b \f2basedir\f1
Prepends the indicated \f2basedir\f1 to locate relocatable objects on the
source machine.
.TP 15
\f4-l \f2limit\f1
Specifies the maximum size in 512-byte blocks
of the output device as \f2limit\f1.
By default, if the output
file is a directory or a mountable device,
\f4pkgmk\f1 will employ the \f4df\f1
command to dynamically calculate the amount of available space on the output
device.
Useful in conjunction with \f4pkgtrans\f1 to create
package with datastream format.
.TP 15
\f4-a \f2arch\f1
Overrides the architecture information provided
in the \f4pkginfo\f1 file with
\f2arch\f1.
.TP 15
\f4-v \f2version\f1
Overrides version information provided in the \f4pkginfo\f1 file with
\f2version\f1.
.TP 15
\f4-p \f2pstamp\f1
Overrides the production stamp definition in the \f4pkginfo\f1 file with
\f2pstamp\f1.
.TP 15
\f4-f \f2prototype\f1
Uses the file \f2prototype\fP as input to the command.
The default name for this file is either
\f4Prototype\f1 or \f4prototype\f1.
.TP 15
\f2variable=value\f1
Places the indicated variable in the packaging environment.
[See \f4prototype\fP(4) for definitions of packaging variables.]
.TP 15
\f2pkginst\f1
Specifies the package by its instance.
\f4pkgmk\fP will automatically create a new instance
if the version and/or architecture is \%different.
A user should specify only a package abbreviation;
a particular instance should not be specified
unless the user is over\%writing it.
.SH NOTES
Entries in the \f4prototype\fP file that reference relative paths
above the rootpath specification will not be compressed.
.P
When the \f4-c\fP option is specified, any \f4!search\fP commands found in the
\f4prototype\fP(4) file will not work.
The \f4-c\fP option should not be used when the argument to the
\f4-d\fP option is used to specify a removable block device.
.SH SEE ALSO
.na
\f4pkginfo\fP(4),
\f4pkgparam\fP(1),
\f4pkgproto\fP(1),
\f4pkgtrans\fP(1),
\f4setinfo\fP(4)
.ad
0707010147d081a403012a8a876c0db502f010250root.7/usr/share/man/man1/pkgparam.1 .if n .pH 1/gen/pkgparam @(#)pkgparam 43.6 of 7/30/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pkgparam 1
.SH NAME
\f4pkgparam\f1 \- displays package parameter values
.SH SYNOPSIS
\f4pkgparam \f1[\f4\-v\f1]\f4 \f1[\f4\-d \f2device\f4\f1]\f4 \f2pkginst\f4 \f1[\f4\f2param\f4\f1[\f4 . . .\f1]\|\f4\f1]\f4
.br
pkgparam \-d \f2device\f4 \f1[\f4\-v\f1]\f4 \f1[\f4\f2param\f4\f1[\f4 . . .\f1]\|\f4\f1]\f4
.br
pkgparam \-f \f2file\f4 \f1[\f4\-v\f1]\f4 \f1[\f4\f2param\f4\f1[\f4 . . .\f1]\|\f4\f1]\f4
.SH DESCRIPTION
\f4pkgparam\f1
displays the value associated with the parameter or parameters
requested on the command line.
The values are located in one of the following places:
(a) in the \f4pkginfo\f1 file for \f2pkginst\f1,
(b) on the \f2device\fP named with the \f4-d\fP option,
or (c) on the specific file named with the \f4\-f\f1 option.
When a \f2device\fP is given, but a \f2pkginst\fP is not
(as shown in the second synopsis),
parameter information for all packages residing on \f2device\f1 is shown.
.P
One parameter value is
shown per line.
Only the value of a parameter is given unless the \f4\-v\f1
option is used.
With this option, the output of the command is in this format:
.P
.in +.5i
.nf
\f2parameter1\f4='\f2value1\f4'\f1
\f2parameter2\f4='\f2value2\f4'\f1
\f2parameter3\f4='\f2value3\f4'\f1
.fi
.in -.5i
.P
If no parameters are specified on the command line, values for all parameters
associated with the package are shown.
.P
Options and arguments for this command are:
.TP 10
\f4\-v\f1
Specifies verbose mode.
Displays name of parameter and its value.
.TP 10
\f4\-d \f2device\f1
Specifies the \f2device\f1 on which a \f2pkginst\f1 is stored.
\f2device\f1 can be
(a) the full pathname to a directory
(such as \f4/var/tmp\f1),
(b) the full pathname to a device
(such as \f4/dev/rmt/*\f1 or \f4/dev/dsk/*\f1)
[see \f4intro\fP(7)],
or (c) a device alias.
The default device is the installation spool directory
(\f4/var/spool/pkg\fP).
.IP
An alias is the unique name by which a device is known.
(For example, the alias for a cartridge tape drive
might be \f4ctape1\f1.)
The name must be limited in length to 64 characters
(\f4DDB_MAXALIAS\f1)
and can contain only alphanumeric characters
and/or any of the following special characters:
underscore (\f4_\f1), dollar sign (\f4$\f1),
hyphen (\f4-\f1), and period (\f4.\f1).
No two devices in the database
can share the same alias.
.TP 10
\f4\-f\f1
Requests that the command read \f2file\f1 for parameter values.
.TP 10
\f2pkginst\f1
Defines a specific package instance for which parameter
values should be displayed.
The format \f2pkginst\f1.\(** can be used to indicate all instances of a package.
When using this format,
enclose the command line in single quotes
to prevent the shell from interpreting the \(** character.
.TP 10
\f2param\f1
Defines a specific parameter whose value should be displayed.
.SH EXIT CODES
If parameter information is not available for the indicated package, the
command exits with a non-zero status.
.SH NOTES
The \f4\-f\f1 synopsis allows you to specify the file from which
parameter values should be extracted.
This file should be in the same
format as a \f4pkginfo\f1
file.
As an example,
such a file might be created during package development
and used while testing software during this stage.
.SH FILES
.TP 30
\f4/var/spool/pkg\fP
default spool directory
.SH SEE ALSO
.na
\f4intro\fP(7),
\f4pkginfo\fP(4),
\f4pkgmk\fP(1),
\f4pkgproto\fP(1),
\f4pkgtrans\fP(1)
.ad
0707010147e081a403012a8a876d0ad702f010250root.7/usr/share/man/man1/pkgproto.1 .if n .pH 1/gen/pkgproto @(#)pkgproto 43.3 of 7/29/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pkgproto 1
.SH NAME
\f4pkgproto\f1 \- generate a \f4prototype\fP file
.SH SYNOPSIS
\f4pkgproto \f1[\f4-i\f1] [\f4-c \f2class\f1] [\f2path1\f1[\f4=\f2path2\f1] . . . ]
.SH DESCRIPTION
\f4pkgproto\f1
scans the indicated paths and generates a \f4prototype\fP file
that may be used as input to the \f4pkgmk\f1 command.
.TP 10
\f4-i\f1
Ignores symbolic links and records the paths as \f4ftype=f\fP (a file)
versus \f4ftype=s\fP(symbolic link)
.TP 10
\f4-c\f1
Maps the class of all paths to \f2class\f1.
.TP 10
\f2path1\f1
Path of directory where objects are located.
.TP 10
\f2path2\f1
Path that should be substituted on output for \f2path1\f1.
.P
If no paths are specified on the command line,
standard input is assumed to be a
list of paths.
If the path listed on the command line is a directory,
the contents of the directory are searched.
However,
if input is read from \f4stdin\f1,
a directory specified as a path will not be searched.
.P
The \f4protoype\fP file attributes \f4mac\fP, \f4fixed\fP, and
\f4inherited\fP, cannot be determined by \f4pkgproto\fP;
to add
these attributes to the \f4prototype\fP file, you must add them
to the file manually.
See \f4prototype\fP(4).
.SH NOTES
By default,
\f4pkgproto\f1 creates symbolic link entries for any symbolic link
encountered (\f4ftype=s\fP).
When you use the \f4-i\f1 option,
\f4pkgproto\f1 creates a file
entry for symbolic links (\f4ftype=f\fP).
The \f4prototype\fP file must
be edited to assign file types such as
\f4v\fP (volatile), \f4e\fP (editable),
or \f4x\f1 (exclusive directory).
\f4pkgproto\f1 detects linked files.
If multiple files are linked together,
the first path encountered is considered
the source of the link.
.SH EXAMPLE
The following two examples show uses of \f4pkgproto\f1 and a partial
listing of the output produced.
.P
Example 1:
.P
.in +.5i
.nf
.ft 4
.vs -1
$ pkgproto /usr/bin=bin /usr/usr/bin=usrbin /etc=etc
f none bin/sed=/bin/sed 0775 bin bin
f none bin/sh=/bin/sh 0755 bin daemon
f none bin/sort=/bin/sort 0755 bin bin
f none usrbin/sdb=/usr/bin/sdb 0775 bin bin
f none usrbin/shl=/usr/bin/shl 4755 bin bin
d none etc/master.d 0755 w#root daemon
f none etc/master.d/kernel=/etc/master.d/kernel 0644 root daemon
f none etc/rc=/etc/rc 0744 root daemon
.ft 1
.vs +1
.in -.5i
.br
.ne 2.2i
Example 2:
.P
.in +.5i
.nf
.ft 4
.vs -1
$ find / \-type d \-print | pkgproto
d none / 755 root root
d none /usr/bin 755 bin bin
d none /usr 755 root root
d none /usr/bin 775 bin bin
d none /etc 755 root root
d none /tmp 7 root root
.ft 1
.vs +1
.fi
.in -.5i
.sp -.5
.SH SEE ALSO
.na
\f4pkginfo\fP(4),
\f4pkgmk\fP(1),
\f4pkgparam\fP(1),
\f4pkgtrans\fP(1)
.ad
0707010147f081a403012a8a876f0fe902f010220root.7/usr/share/man/man1/pkgrm.1 .if n .pH 1m/gen/pkgrm @(#)pkgrm 43.9 of 8/5/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pkgrm 1M
.SH NAME
\f4pkgrm\f1 \- removes a package or set from the system
.SH SYNOPSIS
\f4pkgrm \f1[\f4-n\f1] [\f4-a \f2admin\f1] [\f2pkginst1\f1 [\f2pkginst2\f1[ . . . ]\|]\|]
.P
\f4pkgrm -s \f2spool \f1[\f2pkginst\f1]
.SH DESCRIPTION
\f4pkgrm\f1
will remove a previously installed or partially installed package/set from the
system.
A package is a collection of related files and executables that can be
independently installed.
A set is made up of a special-purpose package,
referred to as a Set Installation Package (SIP),
and a collection of one or more packages that are members of the set.
.PP
A check is made to determine if any other packages depend on the one
being removed.
The action taken if a dependency exists is defined in the
\f2admin\fP file
(see the \f4-a\fP option, below).
.PP
The default state for the command is interactive mode, meaning that
prompt messages are given during processing to allow the
administrator to confirm the actions being taken.
Non-interactive mode can be
requested with the \f4-n\f1 option.
.PP
The \f4-s\f1 option can be used to specify the directory
from which spooled packages should be removed.
.PP
The options and arguments for this command are:
.TP 13
\f4-n\f1
Non-interactive mode.
If there is a need for interaction, the command will exit.
Use of this option requires that at least
one package instance be named upon invocation
of the command.
.TP 13
\f4-a \f2admin\f1
Defines an installation administration file, \f2admin\fP,
to be used in place of the default administration file.
[For a description of the format
of an \f2admin\fP file, see \f4admin\fP(4).]
The token \f4none\f1
overrides the use of any \f2admin\fP file,
and thus forces interaction with the user.
Unless a full pathname is given, \f4pkgrm\f1 looks in
the \f4/var/sadm/install/admin\f1 directory for the file.
By default, the file \f4default\fP in that directory is used.
.TP 13
\f4-s \f2spool\f1
Removes the specified package(s) from the directory \f2spool\f1.
.TP 13
\f2pkginst\f1
A short string used to designate a package/set.
It is composed of one or two parts:
\f2pkg\fP (an abbreviation for the package/set name)
or, if more than one instance of that package exists,
\f2pkg\fP plus \f2inst\fP (an instance identifier).
(The term ``package instance'' is used loosely: it
refers to all instantiations of \f2pkginst\fP,
even those that do not include instance identifiers.)
.IP
The package name abbreviation (\f2pkg\fP)
is the mandatory part of \f2pkginst\fP.
[See \f4pkginfo\fP(1), \f4pkginfo\fP(4).]
.IP
If \f2pkginst\f1 specifies a SIP,
all installed packages which are members of the set,
and the SIP itself, are removed in reverse dependency order.
.IP
The second part (\f2inst\fP),
which is required only if you have
more than one instance of the package in question,
is a suffix that identifies the instance.
This suffix is either a number (preceded by a period)
or any short mnemonic string you choose.
If you don't assign your own instance identifier
when one is required,
the system assigns a numeric one by default.
For example, if you have three instances
of the Advanced Commands package
and you don't create your own mnemonic identifiers
(such as \f4old\fP and \f4beta\fP),
the system adds the suffixes \f4.2\fP and \f4.3\fP
to the second and third packages, automatically.
.IP
To indicate all instances of a package, specify
\f4'\f2pkginst\f4.\(**'\f1,
enclosing the command line in single quotes, as shown,
to prevent the shell from interpreting the \(** character.
Use the token \f4all\f1
to refer to all packages available on the source medium.
.SH SEE ALSO
.na
\f4admin\fP(4),
\f4compver\fP(4),
\f4copyright\fP(4),
\f4depend\fP(4),
\f4installf\fP(1M),
\f4pkgadd\fP(1M),
\f4pkgask\fP(1M),
\f4pkgchk\fP(1M),
\f4pkginfo\fP(1),
\f4pkginfo\fP(4),
\f4pkgmap\fP(4),
\f4pkgmk\fP(1),
\f4pkgparam\fP(1),
\f4pkgproto\fP(1),
\f4pkgtrans\fP(1),
\f4removef\fP(1M),
\f4setinfo\fP(4),
\f4space\fP(4)
.ad
0707010148081a403012a8a8770109602f010250root.7/usr/share/man/man1/pkgtrans.1 .if n .pH 1/gen/pkgtrans @(#)pkgtrans 43.5 of 7/6/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pkgtrans 1
.SH NAME
\f4pkgtrans\f1 \- translate package format
.SH SYNOPSIS
\f4pkgtrans \f1[\f4-ions\f1] \f2device1 device2 \f1[\f2pkginst1\f1 [\f2pkginst2\f1 [ . . . ]
.SH DESCRIPTION
.hw data-stream
\f4pkgtrans\f1 translates an installable package from one format
to another.
It translates:
.IP
a file system format to a datastream
.IP
a datastream to a file system format
.IP
a file system format to another file system format
.P
For removable filesystem media, \f4pkgtrans\fP will optionally
allow the user to format and place a filesystem on the media, and write
a label on the media before transferring the package to the media.
.P
The options and arguments for this command are:
.TP 13
\f4\-i\f1
Copies the \f4pkginfo\fP and \f4pkgmap\fP files.
If the package's category is defined as \f4set\fP, for Set Installation
Packages (SIPs) [see \f4setinfo\fP(4)],
then that package's \f4setinfo\fP file is also copied.
.TP 13
\f4-o\f1
Overwrites the same instance on the destination device,
package instance will be overwritten if it already exists.
.TP 13
\f4-n\f1
Creates a new instance
if any instance of this package already exists.
.TP 13
\f4-s\f1
Indicates that the package should be written to \f2device2\fP
as a datastream rather than as a file system.
The default behavior
is to write to \f2device2\fP in the file system format.
.TP 13
\f2device1\f1
Indicates the source device.
The package or packages on this device will be
translated and placed on \f2device2\f1.
.TP 13
\f2device2\f1
Indicates the destination device.
Translated packages will be placed on this
device.
.TP 13
\f2pkginst\f1
Specifies which package instance or instances
on \f2device1\f1 should be translated.
The token \f4all\f1 may be used to indicate all packages.
\f2pkginst\f4.\(**\f1 can be used to indicate all instances of a package.
If no packages are defined,
a prompt shows all packages on the device and asks which to translate.
If a set is being transferred to datastream format, the \f2pkginst\fP
arguments should begin with the SIP and be followed by the packages
listed in the SIP's \f4setinfo\fP file, in the order in which they
appear in that file.
.SH NOTES
Device specifications can be either the special node name (\f4/dev/diskette\fP)
or the device alias (\f4diskette1\fP).
The device \f4spool\f1 indicates the default spool directory.
Source and destination devices may not be the same.
.P
By default, \f4pkgtrans\f1 will not transfer
any instance of a package if any
instance of that package already exists on the destination device.
Use of
the \f4-n\f1 option will create a new instance if
an instance of this package already exists.
Use of the \f4-o\f1 option will overwrite the same instance
if it already exists.
Neither of
these options are useful if the destination device is a datastream,
since the entire datastream is overwritten anyway.
.P
\f4pkgtrans\fP will optionally create packages on either \f4ufs\fP or
\f4s5\fP file systems, with \f4ufs\fP being the default.
.P
\f4pkgtrans\fP depends on the integrity of the \f4/etc/device.tab\fP file
to determine whether a device can support a datastream and/or
file system formats.
Problems in transferring a device in a particular
format could mean corruption of \f4/etc/device.tab\fP.
.SH EXAMPLE
The following example translates all packages located on the floppy
drive \f4/dev/diskette\f1 and places the translations on
\f4/tmp\f1.
.P
.RS
.ft 4
pkgtrans /diskette1 /tmp all
.ft 1
.RE
.P
The next example translates packages \f4pkg1\f1
and \f4pkg2\f1 located on \f4/tmp\f1 and places
their translations (that is, a datastream) on the \f49track1\f1 output device.
.P
.RS
.ft 4
pkgtrans /tmp 9track1 pkg1 pkg2
.ft 1
.RE
.P
The next example translates \f4pkg1\f1 and \f4pkg2\f1 on \f4tmp\f1
and places them on the diskette in a datastream format.
.P
.RS
.ft 4
pkgtrans -s /tmp /diskette1 pkg1 pkg2
.ft 1
.RE
.SH FILES
\f4/etc/device.tab\fP
.SH SEE ALSO
.na
\f4installf\fP(1M),
\f4pkgadd\fP(1M),
\f4pkgask\fP(1M),
\f4pkginfo\fP(1),
\f4pkginfo\fP(4),
\f4pkgmk\fP(1),
\f4pkgparam\fP(1),
\f4pkgproto\fP(1),
\f4pkgrm\fP(1M),
\f4removef\fP(1M)
.ad
07070101481081a403012a8a87710ae02f010
#0210root.7/usr/share/man/man1/plot.1 .if n .pH 1/bsd/plot @(#)plot 43.7 of 8/12/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.\" Portions of this page were derived from material copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
.\"
.TH plot 1G "BSD System Compatibility"
.SH NAME
\f4plot\f1, \f4aedplot\f1, \f4atoplot\f1, \f4bgplot\f1, \f4crtplot\f1, \f4dumbplot\f1, \f4gigiplot\f1, \f4hpplot\f1, \f4implot\f1, \f4plottoa\f1, \f4t300\f1, \f4t300s\f1, \f4t4013\f1, \f4t450\f1, \f4tek\f1 \- (\s-1BSD\s+1) graphics filters for various plotters
.SH SYNOPSIS
\f4/usr/ucb/plot\f1 [ \f4\-T\f2terminal\f1 ]
.SH DESCRIPTION
\f4plot\f1
reads plotting instructions
[see \f4plot\f1(1)]
from the standard input and produces plotting instructions suitable
for a particular
.I terminal
on the standard output.
.P
If no
.I terminal
is specified, the environment variable
\f4TERM\fP
is used.
The default \%\f2terminal\f1 is \f4tek\f1.
.SH ENVIRONMENT
Except for \f4ver\f1,
the following terminal-types can be used with
\f4lpr \-g\f1
(see \f4lpr\f1)
to produce plotted output:
.RS 0
.TP 0.9i
\f42648\f1 | \f42648a\f1 | \f4h8\f1 | \f4hp2648\f1 | \f4hp2648a\f1
Hewlett Packard\(rg 2648 graphics terminal.
.TP
\f4300\f1
.SM DASI
300 or
.SM GSI
terminal (Diablo\(rg mechanism).
.TP
\f4300s\f1 | \f4300S\f1
.SM DASI
300s terminal (Diablo mechanism).
.TP
\f4450\f1
.SM DASI
Hyterm 450 terminal (Diablo mechanism).
.TP
\f44013\f1
Tektronix\(rg 4013 storage scope.
.TP
\f44014\f1 | \f4tek\f1
Tektronix 4014 and 4015 storage scope
with Enhanced Graphics Module.
(Use 4013 for Tektronix 4014 or 4015 without the Enhanced
Graphics Module).
.TP
\f4aed\f1
.SM AED
512 color graphics terminal.
.HP
\f4bgplot\f1 |
\f4bitgraph\f1
.br
.SM BBN
bitgraph graphics terminal.
.TP
\f4crt\f1
Any crt terminal capable of running
\f4vi\f1(1).
.TP
\f4dumb\f1 | \f4un\f1 | \f4unknown\f1
Dumb terminals without cursor addressing or line printers.
.TP
\f4gigi\f1 | \f4vt125\f1
.SM DEC\(rg
vt125 terminal.
.TP
\f4h7\f1 | \f4hp7\f1 | \f4hp7221\f1
Hewlett Packard 7221 graphics terminal.
.TP
\f4implot\f1
Imagen plotter.
.TP
\f4var\f1
Benson Varian printer-plotter
.TP
\f4ver\f1
Versatec\(rg D1200A printer-plotter.
The output is scan-converted and
suitable input to \f4lpr \-v\f1.
.RE
.br
.ne 2.5i
.SH FILES
.PD 0
.TP 20
.TP
\f4/usr/ucb/aedplot\f1
.TP
\f4/usr/ucb/atoplot\f1
.TP
\f4/usr/ucb/bgplot\f1
.TP
\f4/usr/ucb/crtplot\f1
.TP
\f4/usr/ucb/dumbplot\f1
.TP
\f4/usr/ucb/gigiplot\f1
.TP
\f4/usr/ucb/hpplot\f1
.TP
\f4/usr/ucb/implot\f1
.TP
\f4/usr/ucb/plot\f1
.TP
\f4/usr/ucb/plottoa\f1
.TP
\f4/usr/ucb/t300\f1
.TP
\f4/usr/ucb/t300s\f1
.TP
\f4/usr/ucb/t4013\f1
.TP
\f4/usr/ucb/t450\f1
.TP
\f4/usr/ucb/tek\f1
.TP
\f4/usr/ucb/vplot\f1
.TP
\f4/var/ucb/vplot\f2n\f1
.PD
.SH "SEE ALSO"
\f4lpr\f1(1),
\f4vi\fP(1)
07070101482081a403012a8a87750c7202f010260root.7/usr/share/man/man1/postdaisy.1 '\"macro stdmacro
.if n .pH g1.postdaisy @(#)postdaisy 43.2 of 7/20/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH postdaisy 1
.SH NAME
\f4postdaisy\fP \- PostScript translator for Diablo 630 files
.SH SYNOPSIS
\f4/usr/lib/lp/postscript/postdaisy\fP [\f2options\fP] [\f2files\fP]
.SH DESCRIPTION
The \f4postdaisy\fP filter
translates Diablo 630 daisy-wheel
.I files
into PostScript and writes the results on the standard output.
If no
.I files
are specified, or if \- is one of the input
.I files,
the standard input is read.
The following
.I options
are understood:
.TP 1.0i
\f4\-c \f2num\f1
Print
.I num
copies of each page.
By default only one copy is printed.
.TP 1.0i
\f4\-f \f2name\fP
Print
.I files
using font
.I name.
Any PostScript font can be used,
although the best results will be
obtained only with constant-width fonts.
The default font is Courier.
.TP 1.0i
\f4\-h \f2num\f1
Set the initial horizontal motion index to
\f2num\fP.
Determines the character advance and the default point size,
unless the \f4\-s\fP option is used.
The default is 12.
.TP 1.0i
\f4\-m \f2num\fP
Magnify each logical page by the factor \f2num\f1.
Pages are scaled uniformly about the origin,
which is located near the upper left corner of each page.
The default magnification is 1.0.
.TP 1.0i
\f4\-n \f2num\fP
Print
.I num
logical pages on each piece of paper, where
.I num
can be any positive integer.
By default,
.I num
is set to 1.
.TP 1.0i
\f4\-o \f2list\fP
Print pages whose numbers are given in the comma-separated
.IR list .
The list contains single numbers
.I N
and ranges
\f2N1 \fP\- \f2N2\fP.
A missing
.I N1
means the lowest numbered page, a missing
.I N2
means the highest.
.TP 1.0i
\f4\-p \f2mode\fP
Print
.I files
in either portrait or landscape
.I mode.
Only the first character of
.I mode
is significant.
The default
.I mode
is portrait.
.TP 1.0i
\f4\-r \f2num\fP
Selects carriage return and line feed behavior.
If
.I num
is 1, a line feed generates a carriage return.
If
.I num
is 2, a carriage return generates a line feed.
Setting
.I num
to 3 enables both modes.
.TP 1.0i
\f4\-s \f2num\f1
Use point size
.I num
instead of the default value set by the
initial horizontal motion index.
.TP 1.0i
\f4\-v \f2num\f1
Set the initial vertical motion index to \f2num\fP.
The default is 8.
.TP 1.0i
\f4\-x \f2num\fP
Translate the origin
.I num
inches along the positive x axis.
The default
coordinate system has the origin fixed near the
upper left corner of the page, with positive
x to the right and positive y down the page.
Positive
.I num
moves everything right.
The default offset is 0.25 inches.
.TP 1.0i
\f4\-y \f2num\f1
Translate the origin
.I num
inches along the positive y axis.
Positive
.I num
moves text up the page.
The default offset is \-0.25 inches.
.SH DIAGNOSTICS
An exit status of 0 is returned if
.I files
were successfully processed.
.SH FILES
\f4/usr/lib/lp/postscript/postdaisy.ps
.br
/usr/lib/lp/postscript/forms.ps
.br
/usr/lib/lp/postscript/ps.requests\fP
.SH SEE ALSO
\f4download\fP(1),
\f4dpost\fP(1),
\f4postdmd\fP(1),
\f4postio\fP(1),
\f4postmd\fP(1),
\f4postprint\fP(1),
.br
\f4postreverse\fP(1),
\f4posttek\fP(1)
07070101483081a403012a8a870bd602f010240root.7/usr/share/man/man1/postdmd.1 '\"macro stdmacro
.if n .pH g1.postdmd @(#)postdmd 43.3 of 7/20/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH postdmd 1
.SH NAME
\f4postdmd\fP \- PostScript translator for \s-1DMD\s+1 bitmap files
.SH SYNOPSIS
\f4/usr/lib/lp/postscript/postdmd\fP [\f2options\fP] [\f2files\fP]
.SH DESCRIPTION
\f4postdmd\fP translates \s-1DMD\s+1 bitmap
\f2files\fP,
as produced by \f2dmdps\fP,
or
.I files
written in the Ninth Edition \f4bitfile\fP format
into PostScript and writes the results on the
standard output.
If no
.I files
are specified, or if \- is one of the input
.I files,
the standard input is read.
The following
.I options
are understood:
.TP 1.0i
\f4\-b \f2num\f1
Pack the bitmap in the output file using
.I num
byte patterns.
A value of 0 turns off all packing of the output file.
By default,
.I num
is 6.
.TP 1.0i
\f4\-c \f2num\fP
Print
.I num
copies of each page.
By default only one copy is printed.
.TP 1.0i
\f4\-f\fP
Flip the sense of the bits in
.I files
before printing the bitmaps.
.TP 1.0i
\f4\-m \f2num\f1
Magnify each logical page by the factor
.I num.
Pages are scaled uniformly about the origin,
which by default is located at the center of
each page.
The default magnification is 1.0.
.TP 1.0i
\f4\-n \f2num\fP
Print
.I num
logical pages on each piece of paper,
where
.I num
can be any positive integer.
By default
.I num
is set to 1.
.TP 1.0i
\f4\-o \f2list\fP
Print pages whose numbers are given in the comma-separated
.IR list .
The list contains single numbers
.I N
and ranges
\f2N1 \fP\- \f2N2\fP.
A missing
.I N1
means the lowest numbered page, a missing
.I N2
means the highest.
.TP 1.0i
\f4\-p \f2mode\f1
Print
.I files
in either portrait or landscape
.I mode.
Only the first character of
.I mode
is significant.
The default
.I mode
is portrait.
.TP 1.0i
\f4\-x \f2num\f1
Translate the origin
.I num
inches along the positive x axis.
The default
coordinate system has the origin fixed at the
center of the page, with positive
x to the right and positive y up the page.
Positive
.I num
moves everything right.
The default offset is 0 inches.
.TP 1.0i
\f4\-y \f2num\f1
Translate the origin
.I num
inches along the positive y axis.
Positive
.I num
moves everything up the page.
The default offset is 0.
.PP
Only one bitmap is printed on each logical page,
and each of the input
.I files
must contain complete descriptions of at least one bitmap.
Decreasing the pattern size using the
\f4\-b\fP
option may help throughput on printers with fast processors
(such as \s-1PS-810\s+1s),
while increasing the pattern size will often be the right move
on older models (such as \s-1PS-800\s+1s).
.SH DIAGNOSTICS
An exit status of 0 is returned if
.I files
were successfully processed.
.SH FILES
\f4/usr/lib/lp/postscript/postdmd.ps
.br
/usr/lib/lp/postscript/forms.ps
.br
/usr/lib/lp/postscript/ps.requests\fP
.SH SEE ALSO
\f4download\fP#(1),
\f4dpost\fP(1),
\f4postdaisy\fP(1),
\f4postio\fP(1),
\f4postmd\fP(1),
\f4postprint\fP(1),
.br
\f4postreverse\fP(1),
\f4posttek\fP(1)
07070101484081a403012a8a877801d3f02f010230root.7/usr/share/man/man1/postio.1 '\"macro stdmacro
.if n .pH g1.postio @(#)postio 43.3 of 8/10/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH postio 1
.SH NAME
\f4postio\fP \- serial interface for PostScript printers
.SH SYNOPSIS
\f4postio \-l \f2line\f1 [\f2options\fP] [\f2files\fP]
.SH DESCRIPTION
\f4postio\fP sends
.I files
to the PostScript printer attached to
.I line.
If no
.I files
are specified the standard input is sent.
The first group of
.I options
should be sufficient for most applications:
.TP 1.0i
\f4\-b \f2speed\fP
Transmit data over
.I line
at baud rate \f2speed\fP.
Recognized baud rates are 1200, 2400, 4800, 9600, and 19200.
The default
.I speed
is 9600 baud.
.TP 1.0i
\f4\-l \f2line\f1
Connect to the printer attached to
\f2line\fP.
In most cases there is no default
and \f4postio\fP must be able to read and write
.IR line .
If the
.I line
doesn't begin with a \f4/\fP it may be treated as a Datakit destination.
.TP 1.0i
\f4\-q\fP
Prevents status queries while
.I files
are being sent to the printer.
When status queries are disabled a dummy message is appended
to the log file before each block is transmitted.
.TP 1.0i
\f4\-B \f2num\f1
Set the internal buffer size for reading and writing
.I files
to
.I num
bytes.
By default
.I num
is 2048 bytes.
.TP 1.0i
\f4\-D\fP
Enable debug mode.
Guarantees that everything read on
.I line
will be added to the log file (standard error by default).
.TP 1.0i
\f4\-L \f2file\f1
Data received on
.I line
gets put in
.I file.
The default log
.I file
is standard error.
Printer or status messages that don't show a change in state
are not normally written to
.I file
but can be forced out using the \f4\-D\fP option.
.TP 1.0i
\f4\-P \f2string\fP
Send
.I string
to the printer before any of the input files.
The default
.I string
is simple PostScript code that disables timeouts.
.TP 1.0i
\f4\-R \f2num\f1
Run
.I postio
as a single process if
.I num
is 1 or as separate read and write processes if
.I num
is 2.
By default
\f4postio\fP
runs as a single process.
.PP
The next two
.I options
are provided for users who expect to run \f4postio\fP on their own.
Neither is suitable for use in spooler interface
programs:
.TP 1.0i
\f4-i\fP
Run the program in interactive mode.
Any
.I files
are sent first and followed by the standard input.
Forces separate read and write processes
and overrides many other options.
To exit interactive mode use your interrupt or quit character.
To get a friendly interactive connection with the printer
type \&\f4executive\fP on a line by itself.
.TP 1.0i
\f4\-t\fP
Data received on
.I line
and not recognized as printer or status information is written to
the standard output.
Forces separate read and write processes.
Convenient if you have a PostScript program that
will be returning useful data to the host.
.PP
The last option is not generally recommended and should only
be used if all else fails to provide a reliable
connection:
.TP 1.0i
\f4\-S\fP
Slow the transmission of data to the printer.
Severely limits throughput,
runs as a single process,
disables the
\f4\-q\fP
option,
limits the internal buffer size to 1024 bytes,
can use an excessive amount of \s-1CPU\s+1 time,
and does nothing in interactive mode.
.PP
The best performance will usually be obtained by using
a large internal buffer (the
\f4\-B\fP
option)
and by running the program as separate read and write processes (the
\f4\-R 2\fP
option).
Inability to fork the additional process causes
\f4postio\fP
to continue as a single read/write process.
When one process is used,
only data sent to the printer is flow controlled.
.PP
The
.I options
are not all mutually exclusive.
The \f4\-i\fP option always wins,
selecting its own settings for whatever is
needed to run interactive mode, independent of anything else
found on the command line.
Interactive mode runs as separate read and write processes
and few of the other
.I options
accomplish anything in the presence of the \f4\-i\fP option.
The \f4\-t\fP option
needs a reliable two way connection to the printer and
therefore tries to force separate read and write processes.
The
\f4\-S\fP
option relies on the status query mechanism, so
\f4\-q\fP
is disabled and the program runs as a single process.
.PP
In most cases \f4postio\fP
starts by making a connection to
.I line
and then attempts to force the printer into the
\s-1IDLE\s+1
state by sending an appropriate sequence of
\f4^T\fP (status query),
\f4^C\fP (interrupt), and
\f4^D\fP (end of job) characters.
When the printer goes \s-1IDLE\s+1,
.I files
are transmitted along with an occasional
\f4^T\fP (unless the \f4\-q\fP option was used).
After all the
.I files
are sent the program waits until it's reasonably sure the
job is complete.
Printer generated error messages received at any time
except while establishing
the initial connection (or when running interactive mode) cause
\f4postio\fP
to exit with a non-zero status.
In addition to being added to the log file, printer error messages
are also echoed to standard error.
.SH EXAMPLES
Run as a single process at 9600 baud and send
\f2file1\fP and \f2file2\fP
to the printer attached to \f4/dev/tty01\fP:
.PP
.RS
\f4postio -l /dev/tty01 \f2file1 file2\fP
.RE
.PP
Same as above except two processes are used,
the internal buffer is set to 4096 bytes,
and data returned by the printer gets put in file \f2log\fP:
.PP
.RS
\f4postio -R2 -B4096 -l/dev/tty01 -L\f2log file1 file2\f1
.RE
.PP
Establish an interactive connection with
the printer at Datakit destination \f2my/printer\fP:
.PP
.RS
\f4postio -i -l \f2my/printer\f1
.RE
.PP
Send file program to the printer connected to
\f4/dev/tty22\fP,
recover any data in file results,
and put log messages in file \f2log\fP:
.PP
.RS
\f4postio -t -l /dev/tty22 -L \f2log program\fP >\f2results\f1
.RE
.PP
.SH NOTES
.PP
The input
.I files
are handled as a single PostScript job.
Sending several different jobs, each with their own internal
end of job mark (\f4^D\fP) is not guaranteed to work properly.
\f4postio\fP
may quit before all the jobs have completed and could be restarted
before the last one finishes.
.PP
All the capabilities described above may not be available on every
machine or even across
the different versions of the \s-1UNIX\s+1 system that are
currently supported by the program.
For example, the code needed to connect to a Datakit destination
may work only on System V
and may require that the \s-1DKHOST\s+1 software package be
available at compile time.
.PP
There may be no default
.IR line ,
so using the \f4\-l\fP option
is strongly recommended.
If omitted,
\f4postio\fP
may attempt to connect to the printer using the standard output.
If Datakit is involved,
the \f4\-b\fP option may be ineffective
and attempts by \f4postio\fP
to impose flow control over data in both directions may not work.
The \f4\-q\fP
option can help if the printer is connected to \s-1RADIAN\s+1.
The \f4\-S\fP option
is not generally recommended and should be used only if
all other attempts to establish a reliable connection fail.
.SH DIAGNOSTICS
An exit status of 0 is returned if the files ran successfully.
System errors (such as an inability to open the line)
set the low order bit in the exit status,
while PostScript errors set bit 1.
An exit status of 2 usually means the printer
detected a PostScript error in the input
.I files.
.SH SEE ALSO
\f4download\fP(1),
\f4dpost\fP(1),
\f4postdaisy\fP(1),
\f4postdmd\fP(1),
\f4postmd\fP(1),
\f4postprint\fP(1),
.br
\f4postreverse\fP(1),
\f4posttek\fP(1)
07070101485081a403012a8a877a01b8702f010230root.7/usr/share/man/man1/postmd.1 '\"macro stdmacro
.if n .pH g1.postmd @(#)postmd 43.2 of 7/20/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH postmd 1
.SH NAME
\f4postmd\fP \- matrix display program for PostScript printers
.SH SYNOPSIS
\f4/usr/lib/lp/postscript/postmd\fP
[\f2options\fP] [\f2files\fP]
.SH DESCRIPTION
The \f4postmd\fP filter
reads a series of floating point numbers from
.I files,
translates them into a PostScript gray scale image,
and writes the results on the standard output.
In a typical application the numbers might be
the elements of a large matrix,
written in row major order,
while the printed image could help locate
patterns in the matrix.
If no
.I files
are specified, or if \f4\-\fP is one of the input
.I files,
the standard input is read.
The following
.I options
are understood:
.TP 1.0i
\f4\-b \f2num\f1
Pack the bitmap in the output file using
.I num
byte patterns.
A value of 0 turns off all packing of the output file.
By default,
.I num
is 6.
.TP 1.0i
\f4\-c \f2num\f1
Print
.I num
copies of each page.
By default, only one copy is printed.
.TP 1.0i
\f4\-d \f2dimen\fP
Sets the default matrix dimensions for all input
.I files
to
.IR dimen .
The
.I dimen
string can be given as rows or rows\^\f4x\fP\^columns.
If \f2columns\fP is omitted it will #be set to rows.
By default, \f4postmd\fP
assumes each matrix is square and sets the number of rows
and columns to the square root of the number of elements in
each input file.
.TP 1.0i
\f4-g \f2list\f1
.I List
is a comma or space separated string of integers, each lying between
0 and 255 inclusive,
that assigns PostScript gray scales to the regions of the real line
selected by the \f4\-i\fP option.
255 corresponds to white, and 0, to black.
The \f4postmd\fP filter
assigns a default gray scale that omits white (that is, 255)
and gets darker as the regions move
from left to right along the real line.
.TP 1.0i
\f4\-i \f2list\f1
.I List
is a comma, space or slash(/) separated string of
\f2N\fP floating point numbers that
partition the real line into 2\f2N\f1+1 regions.
The
.I list
must be given in increasing numerical order.
The partitions are used
to map floating point numbers read from the input
.I files
into gray scale integers that are either assigned automatically by
\f4postmd\fP
or arbitrarily selected using the
\f4-g\fP option.
The default interval
.I list
is \f4-1,0,1\fP, which partions the real line into seven regions.
.TP 1.0i
\f4-m \f2num\f1
Magnify each logical page by the factor
.IR num .
Pages are scaled uniformly about the origin
which, by default, is located at the center of
each page.
The default magnification is 1.0.
.TP 1.0i
\f4-n \f2num\f1
Print
.I num
logical pages on each piece of paper,
where
.I num
can be any positive integer.
By default,
.I num
is set to 1.
.TP 1.0i
\f4\-o \f2list\f1
Print pages whose numbers are given in the comma separated
.IR list .
The list contains single numbers
.I N
and ranges
\f2N1 \f1\- \f2N2\f1.
A missing
.I N1
means the lowest numbered page, a missing
.I N2
means the highest.
.TP 1.0i
\f4\-p \f2mode\f1
Print
.I files
in either portrait or landscape
.I mode.
Only the first character of
.I mode
is significant.
The default
.I mode
is portrait.
.TP 1.0i
\f4-w \f2window\f1
.I Window
is a comma or space separated list of four positive integers that
select the upper left and lower right corners of a submatrix from
each of the input
.IR files .
Row and column indices start at 1 in the upper left corner and the
numbers in the input
.I files
are assumed to be written in row major order.
By default, the entire matrix is displayed.
.TP 1.0i
\f4-x \f2num\f1
Translate the origin
.I num
inches along the positive x axis.
The default
coordinate system has the origin fixed at the
center of the page, with positive
x to the right and positive y up the page.
Positive
.I num
moves everything right.
The default offset is 0 inches.
.TP 1.0i
\f4-y \f2num\f1
Translate the origin
.I num
inches along the positive y axis.
Positive
.I num
moves everything up the page.
The default offset is 0.
.PP
Only one matrix is displayed on each logical page,
and each of the input
.I files
must contain complete descriptions of exactly one matrix.
Matrix elements are floating point numbers
arranged in row major order in each input file.
White space, including newlines,
is not used to determine matrix dimensions.
By default, \f4postmd\fP
assumes each matrix is square and sets the number of rows and columns
to the square root of the number of elements in the input file.
Supplying default dimensions on the command line
with the \f4-d\fP option
overrides this default behavior,
and in that case the dimensions apply to all input
.IR files .
.PP
An optional header can be supplied with each input file and is used
to set the matrix dimensions,
the partition of the real line,
the gray scale map, and a window into the matrix.
The header consists of keyword/value pairs, each on a separate line.
It begins on the first line of each input file and ends with the
first unrecognized string, which should be the first matrix element.
Values set in the header take precedence,
but apply only to the current input file.
Recognized header keywords are \&\f4dimension\fP, \&\f4interval\fP,
\&\f4grayscale\fP, and \&\f4window\fP.
The syntax of the value string that follows each keyword
parallels what's accepted by
the \&\f4-d\fP, \&\f4-i\fP, \&\f4-g\fP, and \&\f4-w\fP options.
.SH EXAMPLES
For example, suppose file initially contains the 10 numbers
in a 20x50 matrix.
Then you can produce exactly the same output
by completing three steps.
First, issue the following command line:
.IP
\f4postmd -d20x50 -i"-100 100" -g0,128,254,128,0 \f2file\f1
.PP
Second, prepend the following header to \f2file\fP:
.PP
.RS
.nf
\f4dimension 20x50
interval -100.0 .100e+3
grayscale 0 128 254 128 0\f1
.fi
.RE
.PP
Third, issue the following command line:
.sp .4
.RS
\f4postmd \f2file\f1
.RE
.PP
The interval list partitions the real line into five regions and
the gray scale list maps numbers less than \-100 or greater than 100
into 0 (that is, black),
numbers equal to \-100 or 100 into 128 (that is, 50 percent black),
and numbers between \-100 and 100 into 254 (that is, almost white).
.SH NOTES
The largest matrix that can be adequately displayed is a function
of the interval and gray scale lists, the printer resolution,
and the paper size.
A 600x600 matrix is an optimistic upper bound for a two element interval
list
(that is, five regions) using 8.5x11 inch paper on a 300 dpi printer.
.PP
Using white (that is, 255) in a gray scale list
is not recommended and won't show up in
the legend and bar graph that \f4postmd\fP displays below each image.
.SH DIAGNOSTICS
An exit status of 0 is returned if
.I files
were successfully processed.
.SH FILES
\f4/usr/lib/lp/postscript/postmd.ps
.br
/usr/lib/lp/postscript/forms.ps
.br
/usr/lib/lp/postscript/ps.requests\fP
.SH SEE ALSO
\f4dpost\fP(1),
\f4postdaisy\fP(1),
\f4postdmd\fP(1),
\f4postio\fP(1),
\f4postprint\fP(1),
\f4postreverse\fP(1),
\f4posttek\fP(1)
07070101486081a403012a8a877c0b2502f010250root.7/usr/share/man/man1/postplot.1 .if n .pH g1.postplot @(#)postplot 43.5 of 8/10/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH postplot 1
.SH NAME
\f4postplot\fP \- PostScript translator for \f4plot\fP graphics files
.SH SYNOPSIS
\f4/usr/lib/lp/postscript/postplot\fP [\f2options\fP] [\f2files\fP]
.SH DESCRIPTION
The \f4postplot\fP filter
translates \f4plot\fP(1) graphics
.I files
into PostScript and writes the results on the standard output.
If no
.I files
are specified, or if \f4\-\fP is one of the input
.IR files ,
the standard input is read.
The following
.I options
are understood:
.TP 1.0i
\f4\-c \f2num\f1
Print
.I num
copies of each page.
By default, only one copy is printed.
.TP 1.0i
\f4-f \f2name\f1
Print text using font
.IR name .
Any PostScript font can be used,
although the best results will be obtained
only with constant width fonts.
The default font is Courier.
.TP 1.0i
\f4-m \f2num\f1
Magnify each logical page by the factor
.IR num .
Pages are scaled uniformly about the origin
which, by default, is located at the center of each page.
The default magnification is 1.0.
.TP 1.0i
\f4-n \f2num\f1
Print
.I num
logical pages on each piece of paper,
where
.I num
can be any positive integer.
By default,
.I num
is set to 1.
.TP 1.0i
\f4-o \f2list\f1
Print pages whose numbers are given in the comma-separated
.IR list .
The list contains single numbers
.I N
and ranges
\f2N1 \fP\-\f2 N2\fP.
A missing
.I N1
means the lowest numbered page, a missing
.I N2
means the highest.
.TP 1.0i
\f4-p \f2mode\f1
Print
.I files
in either portrait or landscape
.I mode.
Only the first character of
.I mode
is significant.
The default
.I mode
is landscape.
.TP 1.0i
\f4-w \f2num\f1
Set the line width used for graphics to
.I num
points, where a point is approximately 1/72
of an inch.
By default,
.I num
is set to 0 points, which forces lines to be
one pixel wide.
.TP 1.0i
\f4-x \f2num\f1
Translate the origin
.I num
inches along the positive x axis.
The default
coordinate system has the origin fixed at the
center of the page, with positive
x to the right and positive y up the page.
Positive
.I num
moves everything right.
The default offset is 0.0 inches.
.TP 1.0i
\f4-y \f2num\f1
Translate the origin
.I num
inches along the positive y axis.
Positive
.I num
moves everything up the page.
The default offset is 0.0.
.SH DIAGNOSTICS
An exit status of 0 is returned if
.I files
were successfully processed.
.SH NOTES
The default line width is too small for write-white
print engines, such as the one used by the \s-1PS-2400\s+1.
.SH FILES
\f4/usr/lib/lp/postscript/postplot.ps
.br
/usr/lib/lp/postscript/forms.ps
.br
/usr/lib/lp/postscript/ps.requests\fP
.SH SEE ALSO
\f4download\fP(1),
\f4dpost\fP(1),
\f4postdaisy\fP(1),
\f4postdmd\fP(1),
\f4postio\fP(1),
\f4postmd\fP(1),
\%\f4postprint\fP(1),
\f4postreverse\fP(1),
\f4plot\fP(1)
07070101487081a403012a8a877e0f4b02f010260root.7/usr/share/man/man1/postprint.1 '\"macro stdmacro
.if n .pH g1.postprint @(#)postprint 43.2 of 7/20/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH postprint 1
.SH NAME
\f4postprint\fP \- PostScript translator for text files
.SH SYNOPSIS
\f4/usr/lib/lp/postscript/postprint\fP [\f2options\fP] [\f2file#s\fP]
.SH DESCRIPTION
The \f4postprint\fP filter translates text
.I files
into PostScript and writes the results on the
standard output.
If no
.I files
are specified, or if \f4\-\fP is one of the input
.IR files ,
the standard input is read.
The following
.I options
are understood:
.TP 1.0i
\f4-c \f2num\f1
Print
.I num
copies of each page.
By default, only one copy is printed.
.TP 1.0i
\f4-f \f2name\f1
Print
.I files
using font
.IR name .
Any PostScript font can be used,
although the best results will be
obtained only with constant width fonts.
The default font is Courier.
.TP 1.0i
\f4-l \f2num\f1
Set the length of a page to
.I num
lines.
By default,
.I num
is 66.
Setting
.I num
to 0 is allowed, and will cause
.I postprint
to guess a value, based on the point size that's being used.
.TP 1.0i
\f4-m \f2num\f1
Magnify each logical page by the factor
.IR num .
Pages are scaled uniformly about the origin,
which is located near the upper left corner of each page.
The default magnification is 1.0.
.TP 1.0i
\f4-n \f2num\f1
Print
.I num
logical pages on each piece of paper,
where
.I num
can be any positive integer.
By default,
.I num
is set to 1.
.TP 1.0i
\f4-o \f2list\fP
Print pages whose numbers are given in the comma-separated
.IR list .
The \f2list\fP contains single numbers
.I N
and ranges
\f2N1 \fP\-\f2 N2\fP.
A missing
.I N1
means the lowest numbered page, a missing
.I N2
means the highest.
.TP 1.0i
\f4-p \f2mode\f1
Print
.I files
in either portrait or landscape
.I mode.
Only the first character of
.I mode
is significant.
The default
.I mode
is portrait.
.TP 1.0i
\f4-r \f2num\f1
Selects carriage return behavior.
Carriage returns are ignored if
.I num
is 0,
cause a return to column 1 if
.I num
is 1,
and generate a newline if
.I num
is 2.
The default
.I num
is 0.
.TP 1.0i
\f4-s \f2num\f1
Print
.I files
using point size
.IR num .
When printing in landscape mode
.I num
is scaled by a factor that depends on the
imaging area of the device.
The default size for portrait mode is 10.
.TP 1.0i
\f4-t \f2num\f1
Assume tabs are set every
.I num
columns, starting with the first column.
By default, tabs are set every 8 columns.
.TP 1.0i
\f4-x \f2num\f1
Translate the origin
.I num
inches along the positive x axis.
The default
coordinate system has the origin fixed near the
upper left corner of the page, with positive
x to the right and positive y down the page.
Positive
.I num
moves everything right.
The default offset is 0.25 inches.
.TP 1.0i
\f4-y \f2num\f1
Translate the origin
.I num
inches along the positive y axis.
Positive
.I num
moves text up the page.
The default offset is \-0.25 inches.
.PP
A new logical page is started
after 66 lines have been printed
on the current page,
or whenever an \s-1ASCII\s+1 form feed character is read.
The number of lines per page can be changed using
the \f4-l\fP option.
Unprintable \s-1ASCII\s+1 characters are ignored,
and lines that are too long are silently truncated by the printer.
.SH EXAMPLES
.PP
To print \f2file1\fP and \f2file2\fP in landscape mode,
issue the following command:
.PP
.RS
\f4postprint -pland \f2file1 file2\f1
.RE
.PP
To print three logical pages on each physical page in portrait mode:
.PP
.RS
\f4postprint -n3 \f2file\f1
.RE
.PP
.SH DIAGNOSTICS
An exit status of 0 is returned if
.I files
were successfully processed.
.SH FILES
\f4/usr/lib/lp/postscript/postprint.ps
.br
/usr/lib/lp/postscript/forms.ps
.br
/usr/lib/lp/postscript/ps.requests\fP
.SH SEE ALSO
\f4download\fP(1),
\f4dpost\fP(1),
\f4postdaisy\fP(1),
\f4postdmd\fP(1),
\f4postio\fP(1),
\f4postmd\fP(1),
.br
\f4postreverse\fP(1),
\f4posttek\fP(1)
07070101488081a403012a8a877f0a0202f010280root.7/usr/share/man/man1/postreverse.1 '\"macro stdmacro
.if n .pH g1.postreverse @(#)postreverse 43.3 of 8/10/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH postreverse 1
.SH NAME
\f4postreverse\fP \- reverse the page order in a PostScript file
.SH SYNOPSIS
\f4/usr/lib/lp/postscript/postreverse \fP[\f2options\fP] [\f2file\fP]
.SH DESCRIPTION
The \f4postreverse\fP filter
reverses the page order in files that conform to Adobe's
Version 1.0 or Version 2.0 file structuring conventions,
and writes the results on the standard output.
Only one input
.I file
is allowed and if no
.I file
is specified, the standard input is read.
The following
.I options
are understood:
.TP 1.0i
\f4-o \f2list\f1
Select pages whose numbers are given in the comma-separated
.IR list .
The \f2list\fP contains single numbers
.I N
and ranges
\f2N1 \fP\- \f2N2\fP.
A missing
.I N1
means the lowest numbered page, a missing
.I N2
means the highest.
.TP 1.0i
\f4-r\fP
Don't reverse the pages in
.IR file .
.PP
The \f4postreverse\fP filter
can handle a limited class of files
that violate page independence,
provided all global definitions are bracketed by
\&\f4%%BeginGlobal\fP and \&\f4%%EndGlobal\fP comments.
In addition, files that mark the end of each page
with \&\f4%%EndPage: label ordinal\fP comments
will also reverse properly, provided the prologue and
trailer sections can be located.
If \f4postreverse\fP
fails to find an \&\f4%%EndProlog\fP or \&\f4%%EndSetup\fP comment,
the entire
.I file
is copied, unmodified, to the standard output.
.PP
Because global definitions are extracted from individual
pages and put in the prologue, the output file can be
minimally conforming, even if the input
.I file
wasn't.
.SH EXAMPLES
To select pages 1 to 100 from \f2file\fP and reverse the pages:
.PP
.RS
\f4postreverse -o1-100 \f2file\f1
.RE
.PP
To print four logical pages on each physical page
and reverse all the pages:
.PP
.RS
\f4postprint -n4 \f2file\fP | postreverse\f1
.RE
.PP
To produce a minimally conforming file from output
generated by \f4dpost\fP without reversing the pages:
.PP
.RS
\f4dpost \f2file\fP | postreverse -r\f1
.RE
.PP
.SH DIAGNOSTICS
An exit status of 0 is returned if
.I file
was successfully processed.
.SH NOTES
No attempt has been made to deal with redefinitions of global
variables or procedures.
If standard input is used, the input
.I file
will be read three times before being reversed.
.SH SEE ALSO
\f4download\fP(1),
\f4dpost\fP(1),
\f4postdaisy\fP(1),
\f4postdmd\fP(1),
\f4postio\fP(1),
\f4postmd\fP(1),
\%\f4postprint\fP(1),
\f4posttek\fP(1)
07070101489081a403012a8a87810b2102f010240root.7/usr/share/man/man1/posttek.1 '\"macro stdmacro
.if n .pH g1.posttek @(#)posttek 43.2 of 7/20/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH posttek 1
.SH NAME
\f4posttek\fP \- PostScript translator for tektronix 4014 files
.SH SYNOPSIS
\f4/usr/lib/lp/postscript/posttek\fP [\f2options\fP] [\f2files\fP]
.SH DESCRIPTION
The \f4posttek\fP filter
translates tektronix 4014 graphics
.I files
into PostScript and writes the results on the
standard output.
If no
.I files
are specified, or if \f4\-\fP is one of the input
.IR files ,
the standard input is read.
The following
.I options
are understood:
.TP 1.0i
\f4-c \f2num\fP
Print
.I num
copies of each page.
By default, only one copy is printed.
.TP 1.0i
\f4-f \f2name\fP
Print text using font
.IR name .
Any PostScript font can be used,
although the best results will be
obtained only with constant width fonts.
The default font is Courier.
.TP 1.0i
\f4-m \f2num\f1
Magnify each logical page by the factor
.IR num .
Pages are scaled uniformly about the origin
which, by default, is located at the center of each page.
The default magnification is 1.0.
.TP 1.0i
\f4-n \f2num\f1
Print
.I num
logical pages on each piece of paper,
where
.I num
can be any positive integer.
By default,
.I num
is set to 1.
.TP 1.0i
\f4-o \f2list\f1
Print pages whose numbers are given in the comma-separated
.IR list .
The \f2list\fP contains single numbers
.I N
and ranges
\f2N1 \fP\-\f2 N2\fP.
A missing
.I N1
means the lowest numbered page, a missing
.I N2
means the highest.
.TP 1.0i
\f4-p \f2mode\f1
Print
.I files
in either portrait or landscape
.I mode.
Only the first character of
.I mode
is significant.
The default
.I mode
is landscape.
.TP 1.0i
\f4-w \f2num\fP
Set the line width used for graphics to
.I num
points, where a point is approximately 1/72
of an inch.
By default,
.I num
is set to 0 points, which forces lines to be
one pixel wide.
.TP 1.0i
\f4-x \f2num\f1
Translate the origin
.I num
inches along the positive x axis.
The default
coordinate system has the origin fixed at the
center of the page, with positive
x to the right and positive y up the page.
Positive
.I num
moves everything right.
The default offset is 0.0 inches.
.TP 1.0i
\f4-y \f2num\f1
Translate the origin
.I num
inches along the positive y axis.
Positive
.I num
moves everything up the page.
The default offset is 0.0.
.SH DIAGNOSTICS
An exit status of 0 is returned if
.I files
were successfully processed.
.SH NOTES
The default line width is too small for write-white
print engines, such as the one used by the \s-1PS-2400\s+1.
.SH FILES
\f4/usr/lib/lp/postscript/posttek.ps
.br
/usr/lib/lp/postscript/forms.ps
.br
/usr/lib/lp/postscript/ps.requests\fP
.SH SEE ALSO
\f4download\fP(1),
\f4dpost\fP(1),
\f4postdai#sy\fP(1),
\f4postdmd\fP(1),
\f4postio\fP(1),
\f4postmd\fP(1),
\%\f4postprint\fP(1),
\f4postreverse\fP(1)
0707010148a081a403012a8a8786010b202f010230root.7/usr/share/man/man1/printf.1 .if n .pH 1/gen/printf @(#)printf 43.5 of 7/7/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH printf 1
.SH NAME
\f4printf\f1 \- print formatted output
.SH SYNOPSIS
\f4printf \f2format \f1[\f2arg\f1 . . .]
.SH DESCRIPTION
The
\f4printf\fP
command converts, formats, and prints its
.IR arg s
under control of the
.IR format .
It fully supports conversion
specifications for strings (\f4%s\f1 descriptor);
however, the results are undefined for the other conversion
specifications supported by
\f4printf\fP(3S).
.PP
.TP 10
.I format
a character string
that contains
three types of objects:
1) plain characters, which are simply copied to the output stream;
2) conversion specifications, each of which results in fetching zero or more
.IR arg s;
and 3) C-language escape sequences,
which are translated into the corresponding characters.
.TP 10
.I arg
string(s) to be printed under the control of
.IR format .
The results are undefined if there are insufficient
.IR arg s
for the format.
If the format is exhausted while
.IR arg s
remain, the excess
.IR arg s
are simply ignored.
.PP
Each conversion specification is introduced by
the character
\f4%\f1.
After the
\f4%\f1,
the following
appear in sequence:
.PP
.RS
An optional field, consisting of a decimal digit string followed by a
\f4$\f1,
specifying the next
.I arg
to be converted.
If this field is not provided,
the
.I arg
following the last
.I arg
converted is used.
.PP
An optional decimal digit string specifying a minimum
.IR "field width" .
If the converted value has fewer characters
than the field width,
it is padded on the left (or right,
if the left-adjustment flag `\f4\-\fP' has been
given) to the field width.
The padding is with blanks unless the field width digit string
starts with a zero, in which case the padding is with zeros.
.PP
An optional
.I precision\^
that gives
the maximum number of characters
to be printed from a string in
\f4%s\f1
conversion.
The precision takes the form of a period
(\f4\&.\f1)
followed by a decimal digit string;
a null digit string is treated as zero (nothing is printed).
Padding specified by the precision overrides
the padding specified by the field width.
That is, if \f2precision\fP is specified, its value controls
the number of characters printed.
.PP
A field width or precision or both may be
indicated by an asterisk
\f1(\f4\(**\f1)
instead of a digit string.
In this case, an integer
.I arg\^
supplies
the field width or precision.
The
.I arg\^
that is actually converted is not fetched until
the conversion letter is seen, so the
.IR arg s
specifying field width or precision must appear
.I before\^
the
.I arg\^
(if any) to be converted.
A negative field width argument is taken as a
\f4`\-'\f1
(left-adjustment)
flag followed by a positive field width.
If the precision argument is negative,
it is changed to zero
(nothing is printed).
A non-existent or small field width does not cause truncation of a field;
if the result of a conversion is wider than the field width,
the field is simply expanded to contain the conversion result.
.RE
.PP
The conversion characters and their meanings are:
.TP
\f4%s\f1
The
.I arg\^
is taken to be a string
and characters from the string are printed until
a null character
\f1(\f4\e0\f1)
is encountered or
the number of characters shown by the precision
specification is reached.
If the precision is missing, it is taken to be infinite, so
all characters up to the first null character are printed.
A
null
value for
.I arg\^
yields undefined results.
.TP
\f4%%\f1
Print a
\f4%\f1;
no argument is converted.
.SH EXAMPLES
The command
.PP
.RS
\f4printf '%s %s %s\\n' Good Morning World\fP
.RE
.PP
results in the output:
.PP
.RS
\f5Good Morning World\fP
.RE
.PP
The following command produces the same output.
.PP
.RS
\f4printf '%2$s %s %1$s\\n' World Good Morning\fP
.RE
.PP
Here is an example that prints the first 6 characters of \f4$PATH\fP
left-adjusted in a 10-character field:
.PP
.RS
\f4printf 'First 6 chars of %s are %-10.6s.\en' $PATH $PATH\fP
.RE
.PP
If \f4$PATH\fP has the value \f4/usr/bin:/usr/local/bin\fP,
then the above command would print the following output:
.PP
.RS
\f4First 6 chars of /usr/bin:/usr/local/bin are /usr/b .
.RE
.SH REFERENCES
\f4printf\fP(3S)
0707010148b081a403012a8a878901d3f02f010210root.7/usr/share/man/man1/prof.1 .if n .pH 1/gen/prof @(#)prof 43.4 of 7/27/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH prof 1
.SH NAME
\f4prof\f1 \- display profile data
.SH SYNOPSIS
\f4prof\f1
\f1[\&\f4\-t \f1|\&\f4 c \f1|\&\f4 a \f1|\&\f4 n\f1]
\f1[\&\f4\-o \f1|\&\f4 x\f1]
\f1[\&\f4\-g \f1|\&\f4 l\f1]
\f1[\&\f4\-z\f1]
\f1[\&\f4\-h\f1]
\f1[\&\f4\-s\f1]
\f1[\f4\-m\f1
.IR "mdata" "]"
\f4\-V\f1
[\f2prog\f1]
.SH DESCRIPTION
The
\f4prof\fP
command interprets a profile file
produced by the
\f4monitor\fP
function.
The symbol table in the object file
.I prog\^
\f1(\f4a.out\f1
by default)
is read and correlated with a profile file
\f1(\f4mon.out\f1
by default).
For each external text symbol the percentage
of time spent executing between the address of that symbol
and the address of the next
is printed, together with the number of times that function
was called and the average number of milliseconds per call.
.PP
The mutually exclusive options
\f4\-t\f1, \f4\-c\f1, \f4\-a\f1, and \f4\-n\f1
determine the type of sorting of the output lines:
.TP
\f4\-t\f1
Sort by decreasing percentage of total time (default).
.TP
\f4\-c\f1
Sort by decreasing number of calls.
.TP
\f4\-a\f1
Sort by increasing symbol address.
.TP
\f4\-n\f1
Sort lexically by symbol name.
.PP
The mutually exclusive options
\f4\-o\f1 and \f4\-x\f1
specify the printing of the address of each symbol monitored:
.TP
\f4\-o\f1
Print each symbol address (in octal) along with the symbol name.
.TP
\f4\-x\f1
Print each symbol address (in hexadecimal) along with the symbol name.
.PP
The mutually exclusive options \f4\-g\f1 and \f4\-l\f1 control the
type of symbols to be reported.
The \f4\-l\f1 option must be used with care;
it applies the time spent in a static function to the preceding
(in memory) global function, instead of giving
the static function a separate entry in the report.
If all static functions are properly located
(see example below), this feature can be very useful.
If not, the resulting report may be misleading.
.PP
Assume that \f4A\f1 and \f4B\f1 are global functions
and only \f4A\f1 calls static function \f4S\f1.
If \f4S\f1 is located immediately after \f4A\f1 in the source code (that is,
if \f4S\f1 is properly located),
then,
with the \f4\-l\f1 option,
the amount of time spent in \f4A\f1 can easily be determined,
including the time spent in \f4S\f1.
If,
however,
both \f4A\f1 and \f4B\f1 call \f4S\f1,
then,
if the \f4\-l\f1 option is used,
the report will be misleading;
the time spent during \f4B\f1's call to \f4S\f1 will be
attributed to \f4A\f1\^,
making it appear as if more time had been spent
in \f4A\f1 than really had.
In this case,
function \f4S\f1 cannot be properly located.
.TP
\f4\-g\f1
Include static (non-global) functions.
.TP
\f4\-l\f1
Do not include static (non-global) functions (default).
.P
The following options may be used in any combination:
.TP
\&\f4\-z\f1
Include all symbols in the profile range,
even if associated with zero number of calls and zero time.
.TP
\f4\-h\f1
Suppress the heading normally printed on the report.
(This is useful if the report is to be processed further.)
.TP
\f4\-s\f1
Print a summary of several of the
monitoring parameters and statistics on the standard error output.
.TP
\f4\-m \f2mdata\f1
Use file
\f2mdata\f1
instead of
\f4mon.out\f1
as the input profile file.
.TP
\f4\-V\f1
Print \f4prof\fP version information
on the standard error output.
.P
A program creates a profile file if it has been link edited with
the
\f4\-p\f1
option of
\f4cc\f1.
This option to the
\f4cc\f1
command arranges for calls to
\f4monitor\f1
at the beginning
and end of execution.
It is the call to
\f4monitor\f1
at the end of
execution that causes the system to write a profile file.
The number of calls to a function is tallied
if the
\f4\-p\f1
option
was used when the file containing the
function was compiled.
.P
The name of the file created by a profiled program is
controlled by the environmental variable
\f4PROFDIR\f1.
If
\f4PROFDIR\f1
is not set, \f4mon.out\f1 is produced in the directory current when the
program terminates.
If
\f4PROFDIR=\f2string\f1,
\f2string\f4/\f2pid\f4.\f2progname\f1 is produced,
where
\f2progname\f1
consists of \f4argv[0]\f1 with any path prefix removed,
and
\f2pid\f1
is the process ID of the program.
If
\%\f4PROFDIR\f1
is set, but null, no profiling output are produced.
.P
A single function may be split into subfunctions for profiling
by means of the
\f4MARK\f1
macro [see
\f4prof\f1(5)].
.SH FILES
.ta \w'\f4mon.out \f1'u
\f4mon.out\fP defau#lt profile file
.br
\f4a.out\fP default namelist (object) file
.SH SEE ALSO
\f4cc\fP(1),
\f4exit\fP(2),
\f4lprof\fP(1),
\f4monitor\fP(3C),
\f4prof\fP(5)
\f4profil\fP(2),
.br
.\"The ``\f4lprof\f1'' chapter in
.\"the \f2Programmer's Guide: ANSI C and Programming Support Tools\f1
.SH NOTES
The times reported in successive identical runs may show variances
because of varying cache-hit ratios that result from
sharing the cache with other processes.
Even if a program seems to be the only one using the
machine, hidden background or asynchronous
processes may blur the data.
In rare cases, the clock ticks initiating recording
of the program counter may ``beat'' with loops in a
program, grossly distorting measurements.
Call counts are always recorded precisely, however.
.P
Only programs that call \f4exit\f1
or return from \f4main\f1
are guaranteed to produce a profile file,
unless a final call to \f4monitor\f1 is explicitly coded.
.P
The times for static functions
are attributed to the preceding external
text symbol if the
\f4\-g\f1
option is not used.
However, the call counts for the preceding function are still correct;
that is, the static function call counts are not added to
the call counts of the external function.
.P
If more than one of the options \f4\-t\f1, \f4\-c\f1, \f4\-a\f1,
and \f4\-n\f1 is specified, the last option specified is
used and the user is warned.
.P
Profiling may be used with dynamically linked
executables, but care must be applied.
Currently, shared objects cannot be profiled with \f4prof\f1.
Thus, when a profiled, dynamically linked program is
executed, only the ``main'' portion of the image is sampled.
This means that all time spent outside of the ``main''
object, that is, time spent in a shared object,
will not be included in the profile summary;
the total time reported for the program
may be less than the total time used by the \%program.
.P
Because the time spent in a shared object cannot be
accounted for, the use of shared objects should
be minimized whenever a program is profiled with \f4prof\f1.
If possible, the program should be linked statically before being profiled.
.P
Consider an extreme case.
A profiled program dynamically linked with the shared C library
spends 100 units of time in some \f4libc\f1 routine, say, \f4malloc\f1.
Suppose \%\f4malloc\f1 is called only
from routine \f4B\f1 and \f4B\f1 consumes
only 1 unit of time.
\%Suppose further that routine \f4A\f1
consumes 10 units of time, more than any other routine
in the ``main'' (profiled) portion of the image.
In this case, \f4prof\f1 will conclude
that most of the time is being spent in \f4A\f1
and almost no time is being spent in \f4B\f1.
From this it will be almost impossible to tell
that the greatest improvement can be made
by looking at routine \f4B\f1 and not routine \f4A\f1\^.
The value of the profiler in this case is severely degraded;
the solution is to use archives as much as possible for profiling.
0707010148c081a403012a8a878a09d302f010250root.7/usr/share/man/man1/profiler.1 .if n .pH 1m/gen/profiler @(#)profiler 43.3 of 7/31/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH profiler 1M
.SH NAME
\f4profiler\f1: \f4prfld\f1, \f4prfstat\f1, \f4prfdc\f1, \f4prfsnap\f1, \f4prfpr\f1 \- \s-1UNIX\s+1 system profiler
.SH SYNOPSIS
\f4/usr/sbin/prfld\f1
.br
\f4/usr/sbin/prfstat\fP \f4on\fP
.br
\f4/usr/sbin/prfstat\fP \f4off\fP
.br
\f4/usr/sbin/prfdc\f1
\f2file\f1
[ \f2period\f1 [ \f2off_hour\f1 ] ]
.br
\f4/usr/sbin/prfsnap\f1
\f2file\f1
.br
\f4/usr/sbin/prfpr\f1
[ \f4\-t\f1 ]
\f2file\f1 [ \f2cutoff\f1 ]
.SH DESCRIPTION
\f4prfld\f1,
\f4prfstat\fP,
\f4prfdc\fP,
\f4prfsnap\fP,
and
\f4prfpr\fP
form a system of programs
to facilitate an activity study of the
.SM UNIX
operating system.
.PP
\f4prfld\f1
is used to initialize the recording
mechanism in the system.
It generates a table
containing the starting address of each
system subroutine as extracted from
\f4/stand/unix\f1 and the modules in
\f4/etc/conf/mod.d\f1.
It locks all currently loaded modules into memory.
It is no longer necessary to use \f4prfld\f1,
as this is done automatically by
\f4prfstart on\f1, \f4prfsnap\f1, and \f4prfdc\f1.
To unlock modules after profiling activities are
complete, be sure to run \f4prfstat off\f1.
.PP
\f4prfstat\f1
is used to enable or disable the sampling mechanism.
Profiler overhead is less than 4% as calculated
for 30 text addresses.
\f4prfstat\f1
will also reveal the number of
text addresses
being measured.
.PP
\f4prfdc\f1
and
\f4prfsnap\fP
perform the data collection function of the profiler
by copying the current value of all the text address counters
to a file where the data can be analyzed.
\f4prfdc\f1
will store the counters into
.I file\^
every
.I period\^
minutes and will turn off at
.I off_hour
(valid values for
.I off_hour
are
\f40\f1\-\f424\f1).
\f4prfsnap\f1
collects data at the time of invocation only,
appending the counter values to
.IR file .
.PP
\f4prfpr\f1
formats the data collected by
\f4prfdc\fP
or
\f4prfsnap\fP.
Each text address is converted to the nearest text symbol
and is printed if the percent activity
for that range is greater than
.IR cutoff .
.I cutoff
can be any decimal value greater than or equal to zero.
The \f4-t\f1 option reports time in clock ticks instead
of in percentages.
.SH FILES
.TP 1i
\f4/dev/prf\f1
interface to profile data and text addresses
.TP 1i
\f4/stand/unix\f1
system namelist file
for non-loadable modules.
.TP 1i
\f4/etc/conf/mod.d/\f1*
system namelists for loadable modules.
0707010148d081a403012a8a878c01bd402f01020 root.7/usr/share/man/man1/prs.1 .if n .pH 1/gen/prs @(#)prs 43.4 of 8/2/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH prs 1
.tr ~
.SH NAME
\f4prs\f1 \- print an \s-1SCCS\s+1 file
.SH SYNOPSIS
.na
\f4prs\f1 [\f4\-d\f1[\f2dataspec\f1]] [\f4\-r\f1[\f2\s-1SID\s+1\f1]] [\f4\-e\f1]
[\f4\-l\f1] [\f4\-c\f1[\f2date\-time\f1]] [\f4\-a\f1]
\f2file\f1 . . .
.SH DESCRIPTION
\f4prs\fP
prints, on the standard output, parts or all of an \s-1SCCS\s+1 file
[see \f4sccsfile\fP(4)] in a user-supplied format.
If a directory is named, \f4prs\fP
prints the files in that directory, except the
non-\s-1SCCS\s+1 files
(last component of the path name does not begin with \f4s.\fP)
and unreadable files.
If a name of \f4\-\fP is given, the standard input is read;
each line of the standard input is taken to be the name of an \s-1SCCS\s+1 file
or directory to be processed.
\f4prs\fP silently ignores non-\s-1SCCS\s+1 files and unreadable files.
.PP
Arguments to \f4prs\fP, which may appear in any order, consist of
keyletter arguments and file names.
.PP
The keyletter arguments apply independently to each named file:
.RS 0
.TP 15
\f4\-d\f1[\f2dataspec\f1]
Specifies the output data specification.
The
\f2dataspec\f1
is a string consisting of \s-1SCCS\s+1 file
data keywords
(see the
``Data Keywords''
section)
interspersed with optional user-supplied text.
.TP
\f4\-r\f1[\s-1\f2SID\f1\s+1]
Specifies the
.SM SCCS
identification
(\s-1SID\s+1)
string of a delta for which information is desired.
The default is the top delta.
.TP
\f4\-e\f1
Requests
information for all deltas created
earlier
than and including the delta designated via the
\f4\-r\f1
keyletter or the date given by the
\f4\-c\f1
option.
.TP
\f4\-l\f1
Requests
information for all deltas created
later
than and including the delta designated via the
\f4\-r\f1
keyletter or the date given by the
\f4\-c\f1
option.
.TP
\f4\-c\f1[\f2date\-time\f1]
The cutoff date\-time in the form:
.IP
\f2\s-1YY\f1[\fPMM\f1[\fPDD\f1[\fPHH\f1[\fPMM\f1[\fPSS\f1]\s+1
.IP
Units omitted from the date\-time default to their
maximum possible values; for example, \f4\-c7502\f1
is equivalent to \f4-c750228235959\f1.
Any number of non-numeric characters may separate
the fields of the cutoff
date; for example,
\f4"\-c77/2/2 9:22:25"\f1.
.TP
\f4\-a\f1
Requests
printing of information for both removed,
that is, delta type = R,
[see
\f4rmdel\fP(1)]
and existing,
that is, delta type = D,
deltas.
If the
\f4\-a\f1
keyletter is not specified,
information for existing deltas only is provided.
.RE
.SS "Data Keywords"
Data keywords
specify those parts of an \s-1SCCS\s+1 file that are to be retrieved and output.
All parts of an \s-1SCCS\s+1 file [see
\f4sccsfile\fP(4)]
have an associated data keyword.
There is no limit on the number of times a data keyword
may appear in a
\f2dataspec\f1.
.PP
The information printed by
\f4prs\fP
consists of:
(1) the user-supplied text; and
(2) appropriate values (extracted from the \s-1SCCS\s+1 file)
substituted for the recognized data keywords
in the order of appearance in the \f2dataspec\^\fP.
The format of a data keyword value is either
``Simple''
(S), in which
keyword substitution is direct, or
``Multi-line''
(M), in which keyword substitution is followed
by pressing RETURN.
.PP
User-supplied text is any text other than
recognized data keywords.
A tab is specified
by \f4\et\fP and RETURN/new-line is specified by \f4\en\fP.
The default data keywords are:
.P
.RS
"\f4:Dt:#\\t\f4:DL\f4:\f4\\nMRs\f4:\fP\\n\f4:\fPMR\f4:\fPCOMMENTS\f4:\fP\\n\f4:\fPC\f4:\fP"
.RE
.P
.TS
center;
c1 lw(1.75i) c1 c1 c0
cf4 lp8 cp8 cf2 cp8 .
.na
Keyword Data Item File Section Value Format
_
:Dt: Delta information Delta Table \f1See below*\fP S
:DL: T{
Delta line statistics
T} " \f4:Li:/:Ld:/:Lu:\fP S
:Li: T{
Lines inserted by Delta
T} " n S
:Ld: T{
Lines deleted by Delta
T} " n S
:Lu: T{
Lines unchanged by Delta
T} " n S
:DT: Delta type " \f4D\fP\^~or~\f4R\fP\^ S
:I: T{
SCCS ID string (SID)
T} " \f4:R:.:L:.:B:.:S:\fP S
:R: Release number " n S
:L: Level number " n S
:B: Branch number " n S
:S: Sequence number " n S
:D: T{
Date Delta created
T} " \f4:Dy:/:Dm:/:Dd:\fP S
:Dy: T{
Year Delta created
T} " nn S
:Dm: T{
Month Delta created
T} " nn S
:Dd: T{
Day Delta created
T} " nn S
:T: T{
Time Delta created
T} " \f4:Th:Tm:Ts:\fP S
:Th: T{
Hour Delta created
T} " nn S
:Tm: T{
Minutes Delta created
T} " nn S
:Ts: T{
Seconds Delta created
T} " nn S
:P: T{
Programmer who created Delta
T} " logname S
:DS: T{
Delta sequence number
T} " n S
:DP: T{
Predecessor Delta seq-no.
T} " n S
:DI: T{
Seq-no. of deltas incl., excl., ignored
T} " \f4:Dn:/:Dx:/:Dg:\fP S
:Dn: Deltas included (seq #) " \f4:DS:~:DS:\fP\|.\^.\^. S
:Dx: Deltas excluded (seq #) " \f4:DS:~:DS:\fP\|.\^.\^. S
:Dg: Deltas ignored (seq #) " \f4:DS:~:DS:\fP\|.\^.\^. S
:MR: MR numbers for delta " text M
:C: Comments for delta " text M
:UN: User names User Names text M
:FL: Flag list Flags text M
.TE
.TS
center;
c1 lw(1.75i) c1 c1 c0
cf4 lp8 cp8 cf2 cp8 .
.na
Keyword Data Item File Section Value Format
_
:Y: Module type flag " text S
:MF: T{
MR validation flag
T} " \f4yes\f1\^~or~\f4no\f1 S
:MP: T{
MR validation pgm name
T} " text S
:KF: T{
Keyword error/warning flag
T} " \f4yes\f1\^~or~\f4no\f1 S
:KV: Keyword validation string " text S
:BF: Branch flag " \f4yes\f1\^~or~\f4no\f1 S
:J: Joint edit flag " \f4yes\f1\^~or~\f4no\f1 S
:LK: Locked releases " \f4:R:\fP\|.\^.\^. S
:Q: User-defined keyword " text S
:M: Module name " text S
:FB: Floor boundary " \f4:R:\fP S
:CB: Ceiling boundary " \f4:R:\fP S
:Ds: Default SID " \f4:I:\fP S
:ND: Null delta flag " \f4yes\f1\^~or~\f4no\f1 S
:FD: T{
File descriptive text
T} Comments text M
:BD: Body Body text M
:GB: Gotten body " text M
:W: T{
A form of what\^(1) string
T} N/A \f4:Z::M:\et:I:\fP S
:A: T{
A form of what\^(1) string
T} N/A \f4:Z::Y:~:M:~:I::Z:\fP S
:Z: T{
what\^(1) string delimiter
T} N/A \f4@\&(#)\fP S
:F: SCCS file name N/A text S
:PN: SCCS file path name N/A text S
.TE
.P
.ce 1
* \f4:Dt:~=~:DT:~:I:~:D:~:T:~:P:~:DS:~:DP:\fP
.SH EXAMPLES
The command
.P
.RS
.ft 4
prs \-d"Users and/or user IDs for :F: are:\en:UN:" s.file
.ft 1
.RE
.PP
may produce on the standard output:
.PP
.RS
.nf
.ft 5
Users and/or user IDs for s.file are:
xyz
131
abc
.ft 1
.fi
.RE
.P
The command
.P
.RS
.ft 4
prs \-d"Newest delta for pgm :M:: :I: Created :D: By :P:" \-r s.file
.ft 1
.RE
.PP
may produce on the standard output:
.P
.RS
.ft 5
Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas
.ft 1
.RE
.PP
The default case:
.P
.RS
.ft 4
prs s.file
.ft 1
.RE
.PP
produces on the standard output:
.PP
.RS
.nf
.ft 5
D 1.1 77/12/1 00:00:00 cas 1 0/0/0
MRs:
bl78-12345
bl79-54321
COMMENTS:
this is the comment line for s.file initial delta
.ft 1
.fi
.RE
.PP
for each delta table entry of the ``D'' type.
The only keyletter argument allowed to be used with the
``special case''
is the
\f4\-a\f1
keyletter.
.SH FILES
.TP 10
\f4/var/tmp/pr?\fP
.SH "SEE ALSO"
\f4admin\fP(1),
\f4delta\fP(1),
\f4get\fP(1),
\f4help\fP(1),
\f4sccsfile\fP(4)
.SH DIAGNOSTICS
Use
\f4help\fP(1)
for explanations.
.tr ~~
0707010148e081a403012a8a878d01ab02f01020 root.7/usr/share/man/man1/prt.1 .if n .pH 1/bsd/prt @(#)prt 43.8 of 8/12/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.\" Portions of this page were derived from material copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
.\"
.TH prt 1 "BSD Compatibility Package"
.if n .ds )Q '
.if t .ds )Q \\(aa
.SH NAME
\f4prt\f1 \- (\s-1BSD\s+1) display the delta and commentary history of an SCCS file
.SH SYNOPSIS
\f4/usr/ucb/prt\f1 [\f4\-abdefistu\f1] [\f4\-y\f1[\f2SID\f1]] [\f4\-c\f1[\f2cutoff\f1]
[\f4\-r\f1[\f2rev-cutoff]] \f2file\f1 . . .
.SH DESCRIPTION
Note: the
\f4prt\f1
command is an older version of
\f4prs\f1(1)
that in most circumstances is more convenient to use,
but is less flexible than
\f4prs\f1.
.P
\f4prt\f1
prints part or all of an
.SM SCCS
file in a useful format.
If a directory is named,
\f4prt\f1
behaves as though each file in the directory were
specified as a named file,
except that non-\s-1SCCS\s0 files
(last component of the pathname does not begin with
\f4s.\f1)
and unreadable files
are silently ignored.
If a name of
\f1`\f4\-\f1'
is given, the standard input is read;
each line of the standard input is taken to be the name of an
.SM SCCS
file to be processed.
Again, non-\s-1SCCS\s0 files and unreadable files are silently ignored.
.P
The following options are available with
\f4prt :\f1
.TP
\f4\-a\f1
Print those types of deltas normally not printed by the
\f4d\f1
keyletter.
These are types
\f4R\f1
(removed).
This keyletter is effective only if the
\f4d\f1
keyletter is also specified (or assumed).
.TP
\f4\-b\f1
Print the body of the
.SM SCCS
file.
.TP
\f4\-d\f1
This keyletter normally prints
delta table entries of the
\f4D\f1
type.
.TP
\f4\-e\f1
This keyletter implies the
\f4d\f1,
\f4i\f1,
\f4u\f1,
\f4f\f1,
and
\f4t\f1
keyletters and is provided for convenience.
.TP
\f4\-f\f1
Print the flags of the named file.
.TP
\f4\-i\f1
Print the serial numbers of those deltas included,
excluded, and ignored.
This keyletter is effective only if the
\f4d\f1
keyletter is also specified (or assumed).
.RS
.P
The following format is used to print those
portions of the
.SM SCCS
file as specified by the above keyletters.
The printing of each delta table entry
is preceded by a
NEWLINE.
.P
.PD 0v
.\" tags for the list of delta table components:
.\" cobble up a bullet.
.if n .ds bu "\o'o+'
.if t .ds bu \(bu
.nr Tw \w'\*(bu'u+(2n)u
.TP \n(Twu
\*(bu
Type of delta
\f1(\f4D\f1
or
\f4R\fP).
.TP \n(Twu
\*(bu
SPACE.
.TP \n(Twu
\*(bu
.SM SCCS
identification string
(\s-1SID\s0).
.TP \n(Twu
\*(bu
TAB.
.TP \n(Twu
\*(bu
Date and time of creation
(in the form
\s-1YY/MM/DD HH:MM:SS\s0).
.TP \n(Twu
\*(bu
SPACE.
.TP \n(Twu
\*(bu
Creator.
.TP \n(Twu
\*(bu
TAB.
.TP \n(Twu
\*(bu
Serial number.
.TP \n(Twu
\*(bu
SPACE.
.TP \n(Twu
\*(bu
Predecessor delta's serial number.
.TP \n(Twu
\*(bu
TAB.
.TP \n(Twu
\*(bu
Statistics
(in the form inserted/\%deleted/\%unchanged).
.TP \n(Twu
\*(bu
NEWLINE.
.TP \n(Twu
\*(bu
``Included:\c
TAB'',
followed by
\s-1SID\s0's
of deltas included, followed by
NEWLINE
(only if there were any such deltas and if
\f4i\f1
keyletter was \%supplied).
.TP \n(Twu
\*(bu
``Excluded:\c
TAB'',
followed by
\s-1SID\s0's
of deltas excluded, followed by
NEWLINE
(see note above).
.TP \n(Twu
\*(bu
``Ignored:\c
TAB'',
followed by
\s-1SID\s0's
of deltas ignored, followed by
NEWLINE
(see note above).
.TP \n(Twu
\*(bu
``\s-1MR\s0s:\c
TAB'',
followed by
.SM MR
numbers related to the delta, followed by
NEWLINE
(only if any
.SM MR
numbers were supplied).
.TP \n(Twu
\*(bu
Lines of comments (delta commentary), followed by newline
(if any were supplied).
.PD
.RE
.TP
\f4\-s\f1
Print only the first line of the delta table entries;
that is, only up to the statistics.
This keyletter is effective only if the
\f4d\f1
keyletter is also specified (or assumed).
.TP
\f4\-t\f1
Print the descriptive text
contained in the file.
.TP
\f4\-u\f1
Print the login-names and/or numerical group
.SM ID\s0s
of those users allowed to make deltas.
.TP
\f4\-y\fP[\f2\s-1SID\s0\f1]
Print the delta table entries to stop
when the delta just printed has the specified
\s-1SID\s0.
If no delta in the table has the specified
\s-1SID\s0,
the entire table is printed.
If no
.SM SID
is specified, the first delta in the delta table is printed.
This keyletter will print the entire
delta table entry for each delta
as a single line (the
NEWLINE
in the normal multi-line format of the
\f4d\f1
keyletter are replaced by
SPACE
characters)
preceded by the name of the
.SM SCCS
file being processed, \%followed by a
\f4:\f1,
followed by a
TAB.
This keyletter
is effective only if the
\f4d\f1
keyletter is also specified (or assumed).
.TP
\f4\-c\fP[\f2cutoff\^\f1]
Stop printing the delta table entries
if the delta about to be printed is older than the
specified cutoff date-time (see
\f4get\f1(1)
for the format of date-time).
If no date-time is supplied, the
epoch 0
\s-1GMT\s0
Jan. 1, 1970 is used.
As with the
\f4y\f1
keyletter, this keyletter will cause the entire delta table
entry to be printed as a single line and
to be preceded by the name of the
.SM SCCS
file being processed,
followed by a
\f4:\f1,
followed by a tab.
This keyletter is effective only if the
\f4d\f1
keyletter is also specified (or assumed).
.TP
\f4\-r\fP[\f2rev-cutoff\^\f1]
Begin printing the delta table entries
when the delta about to be printed
is older than or equal to the
specified cutoff date-time (see#
\f4get\f1(1)
for the format of date-time).
If no date-time is supplied, the
epoch 0
\s-1GMT\s0
Jan. 1, 1970 is used.
(In this case, nothing will be printed).
As with the
\f4y\f1
keyletter, this keyletter will cause the entire delta table
entry to be printed as a single line and
to be preceded by the name of the
.SM SCCS
file being processed,
followed by a
\f4:\f1,
followed by a tab.
This keyletter is effective only if the
\f4d\f1
keyletter is also specified (or assumed).
.P
If any keyletter but
\f4y\f1,
\f4c\f1,
or
\f4r\f1
is supplied, the name of the file being
processed (preceded by one
NEWLINE
and followed by two
NEWLINE
characters) is printed before its contents.
.P
If none of the
\f4u\f1,
\f4f\f1,
\f4t\f1,
or
\f4b\f1
keyletters is supplied, the
\f4d\f1
keyletter is assumed.
.P
Note: the
\f4s\f1
and
\f4i\f1
keyletters, and the
\f4c\f1
and
\f4r\f1
keyletters are mutually exclusive;
therefore, they may not be specified together on the same
\f4prt\f1
command.
.P
The form of the delta table
as produced by the
\f4y\f1,
\f4c\f1,
and
\f4r\f1
keyletters makes it easy to sort multiple delta tables in
chronological order.
.P
When both the
\f4y\f1
and
\f4c\f1
or the
\f4y\f1
and
\f4r\f1
keyletters are supplied,
\f4prt\f1
will stop printing when the first of the two conditions is met.
.SH "SEE ALSO"
\f4admin\fP(1),
\f4delta\fP(1),
\f4get\fP(1),
\f4prs\fP(1),
\f4sccs\fP(1),
\f4sccsfile\fP(4),
\f4what\fP(1)
0707010148f081a403012a8a878f0aef02f010240root.7/usr/share/man/man1/prtvtoc.1 .if n .pH 386.prtvtoc @(#)prtvtoc 43.5 of 7/29/92
.\" Copyright 1991, 1992 UNIX System Laboratories, Inc.
.TH prtvtoc 1M
.SH NAME
\f4prtvtoc\fP \- disk information display utility
.SH SYNOPSIS
\f4prtvtoc\fP [\f4-aep\fP] [\f4-f\fP \f2vtoc-file\fP] \f2raw-device\fP
.SH DESCRIPTION
The default and primary function of \f4prtvtoc\fP
is to display the contents of
the VTOC (Volume Table Of Contents).
The information displayed for each
valid slice includes slice number, slice tag,
slice flag/permissions, slice
start sector, slice size (in sectors).
.SS Options
.IP "\f4\-a\fP"
Print the alternates tables (bad tracks and bad sectors).
.IP "\f4\-e\fP"
Creates or add information to the \f4/etc/partitions\fP file.
This option is provided to allow support for \f4mkpart\fP(1M).
Dependence on this feature is not suggested since it will not
be supported in a future release.
.IP "\f4\-p\fP"
Print the information contained in the \f4pdinfo\fP structure.
.IP "\f4\-f\fP \f2vtoc-file\fP"
Write the current contents of the VTOC into
the \f2vtoc-file\fP in a condensed format.
The format of the file is slice number,
slice tag value, slice flag value, slice start
sector, slice size (in sectors).
The purpose of this file is to
be input for the \f4edvtoc\fP command.
.IP "\f2raw-device\fP"
The character special device for the
disk drive to be accessed.
It must be the slice 0 device to represent the
entire device (for example, \f4/dev/rdsk/0s0\fP
or \f4/dev/rdsk/c0t0d0s0\fP).
.SS Files
\f4/dev/rdsk/c?t?d?s0\fP
.SH USAGE
When editing the VTOC, the following entries are the valid slice
tags and slice \%permission flags.
.TS
center;
l s s
lf4 lf4 l.
Slice Tags
_
#define V_BOOT 0x01 /* Boot slice */
#define V_ROOT 0x02 /* Root filesystem */
#define V_SWAP 0x03 /* Swap filesystem */
#define V_USR 0x04 /* Usr filesystem */
#define V_BACKUP 0x05 /* full disk */
#define V_ALTS 0x06 /* alternate sector space */
#define V_OTHER 0x07 /* non-unix space */
#define V_ALTTRK 0x08 /* alternate track space */
#define V_STAND 0x09 /* Stand slice */
#define V_VAR 0x0a /* Var slice */
#define V_HOME 0x0b /* Home slice */
#define V_DUMP 0x0c /* dump slice */
.sp
.T&
l s s
lf4 lf4 l.
Slice Permission Flags
_
#define V_UNMNT 0x01 /* Unmountable partition */
#define V_RONLY 0x10 /* Read only */
#define V_VALID 0x200 /* Partition is valid to use */
.TE
The start and size value are in absolute sector numbers where the
first sector on the drive is 0 (which is reserved
for the partition table).
Slices should start and end on a cylinder boundary if possible.
The head, cylinder and sectors/track
information provided by \f4prtvtoc \-p\fP
will assist in the calculations.
Slices should not overlap (slice 0 is the exception,
it describes the entire UNIX partition).
.SH "REFERENCE"
\f4edvtoc\fP(1M),
\f4sd01\fP(7)
0707010149081a403012a8a879101e8802f010230root.7/usr/share/man/man1/ps.bsd.1 .if n .pH 1/bsd/ps @(#)ps 43.7 of 8/12/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.\" Portions of this page were derived from material copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
.\"
.\" Portions of this page were derived from material copyright (c) 1980 Regents of the University of California.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.TH ps 1 "BSD System Compatibility"
.SH NAME
\f4ps\f1 \- (\s-1BSD\s+1) display the status of current processes
.SH SYNOPSIS
\f4/usr/ucb/ps\f1
[
\f4\-acglnrSuUvwx\f1
] [
\f4\-t\f2term\f1
] [
.I num
]
.SH DESCRIPTION
.P
The
\f4ps\f1
command displays information about processes.
Normally, only those processes that are running with your effective user
.SM ID
and are attached to a controlling terminal (see
\f4termio\f1(7))
are shown.
Additional categories of processes
can be added to the display using various options.
In particular, the
\f4\-a\f1
option allows you to include processes that are not owned by you
(that do not have your user
.SM ID\s0),
and the
\f4\-x\f1
option allows you to
include processes without control terminals.
When you specify
both
\f4\-a\f1
and
\f4\-x\f1,
you get processes owned by anyone, with or without a control
terminal.
The
\f4\-r\f1
option restricts the list of processes printed to running
and runnable processes.
.P
\f4ps\f1
displays the process
.SM ID\s0,
under
.SM PID\s0;
the control terminal (if any), under
.SM TT\s0;
the cpu time used by the
process so far, including both user and system time, under
.SM TIME\s0;
the state of the process, under S;
and finally, an indication of the
.SM COMMAND
that is running.
.P
The state is given by a single letter from the
following:
.RS
.TP
.PD 0
\f4O\f1
Process is running on a processor.
.TP
\f4S\f1
Sleeping.
Process is waiting for an event to complete.
.TP
\f4R\f1
Runnable.
Process is on run queue.
.TP
\f4I\f1
Idle.
Process is being created.
.TP
\f4Z\f1
Zombie state.
Process terminated and parent not waiting.
.TP
\f4T\f1
Traced.
Process stopped by a signal because parent is tracing
it.
.TP
\f4X\f1
\f4SXBRK\fP
state.
Process is waiting for more primary memory.
.PD
.RE
.P
The following options must all be combined to form
the first argument:
.TP 0.5i
\f4\-a\f1
Include information about processes owned by others.
.TP
\f4\-c\f1
Display the command name, as stored internally in the system for purposes
of accounting, rather than the command arguments, which are kept
in the process' address space.
This is more reliable, if less informative,
since the process is free to destroy the latter information.
.TP
\f4\-g\f1
Display all processes.
Without this option,
\f4ps\f1
only prints interesting processes.
Processes are deemed to be uninteresting if they are process group leaders.
This normally eliminates top-level command interpreters and processes
waiting for users to login on free terminals.
.TP
\f4\-l\f1
Display a long listing, with fields
\f4F\f1,
\f4PPID\f1,
\f4CP\f1,
\f4PRI\f1,
\f4NI\f1,
\f4SZ\f1,
\f4RSS\fP
and
\f4WCHAN\fP
as described below.
.TP
\f4\-n\f1
Produce numerical output for some fields.
In a user listing, the
\f4USER\fP
field is replaced by a
\f4UID\fP
field.
.TP
\f4\-r\f1
Restrict output to running and runnable processes.
.TP
\f4\-S\f1
Display accumulated
.SM CPU
time used by this process and all of its reaped
children.
.TP
\f4\-u\f1
Display user-oriented output.
This includes fields
\f4USER\f1,
\f4SZ\f1,
\f4RSS\fP
and
\f4START\fP
as described below.
.TP
\f4\-U\f1
Update the private database (\f4/etc/ps_data\fP) where
\f4ps\f1
keeps system information.
This option may be used solely by privileged users.
.TP
\f4\-v\f1
Display a version of the output containing virtual memory.
This includes fields
\f4SIZE\fP
and
\f4RSS\f1,
described below.
.TP
\f4\-w\f1
Use a wide output format (132 columns rather than 80); if repeated,
that is,
\f4\-ww\f1,
use arbitrarily wide output.
This information is used to decide how much of long commands to print.
.TP
\f4\-x\f1
Include processes with no controlling terminal.
.TP
\f4\-t\f2term\f1
List only process data associated with the
terminal,
.IR term .
Terminal identifiers may be specified in one of two
forms: the device's file name
(for example,
\f4tty04\f1
or
\f4term/14\f1)
or, if the device's file name starts with
\f4tty\f1,
just the digit identifier
(for example,
\f404\f1).
.TP
.I num
A process number may be given, in which case the output
is restricted to that process.
This option must be supplied last.
.SH "DISPLAY FORMATS"
Fields that are not common to all output formats:
.TP 0.5i
\f4USER\fP
Name of the owneg#r of the process.
.TP
\f4NI\fP
Process scheduling increment
[see \f4getpriority\f1(3) and \f4nice\f1(3C)].
.TP
.PD 0
\f4SIZE\fP
.TP
\f4SZ\fP
The combined size of the data and stack segments (in kilobyte units)
.PD
.TP
\f4RSS\fP
Real memory (resident set) size of the process (in kilobyte units).
.TP
\f4UID\fP
Numerical user-\s-1ID\s0 of process owner.
.TP
\f4PPID\fP
Numerical
.SM ID
of parent of process.
.TP
\f4CP\fP
Short-term
.SM CPU
utilization factor (used in scheduling).
.TP
\f4PRI\fP
The priority of the process (higher numbers
mean lower priority).
.TP
\f4START\fP
The starting time of the process, given in hours,
minutes, and seconds.
A process begun more than 24 hours before
the
\f4ps\f1
inquiry is executed
is given in months and days.
.TP
\f4WCHAN\fP
The address of an event for which the process is
sleeping,
or in
\f4SXBRK\fP
state
(if blank, the process is running).
.TP
\f4F\f1
Flags (hexadecimal and additive) associated with the process:
.RS 0.5i
.PD 0
.TP
\f400\f1
Process has terminated.
Process table now available.
.TP
\f401\f1
A system process, always in primary memory.
.TP
\f402\f1
Parent is tracing process.
.TP
\f404\f1
Tracing parent's signal has stopped process.
Parent is waiting, see
\f4ptrace\f1(2).
.TP
\f408\f1
Process is currently in primary memory.
.TP
\f410\f1
Process currently in primary memory, locked until an
event is completed.
.PD
.RE
.P
A process that has exited and has a parent, but has not
yet been waited for by the parent is marked
\f1<\f4defunct\f1>;
otherwise,
\f4ps\f1
tries to determine the command name and arguments
given when the process was created by examining the
user block.
.SH FILES
.PD 0
.TP 20
\f4/dev\f1
.TP
\f4/dev/sxt/*\f1
.TP
\f4/dev/tty*\f1
.TP
\f4/dev/xt/*\f1
terminal
\f1(\f4tty\f1)
names searcher files
.TP
\f4/dev/kmem\f1
kernel virtual memory
.TP
\f4/dev/swap\f1
default swap device
.TP
\f4/dev/mem\f1
memory
.TP
\f4/etc/passwd\f1
.SM UID
information supplier
.TP
\f4/etc/ps_data\f1
internal data structure
.PD
.SH "SEE ALSO"
\f4getpriority\f1(3),
\f4kill\fP(1),
.BT "User's Reference Manual"
\f4lseek\fP(2),
.BT "Programmer's Reference Manual"
\f4nice\f1(3C),
\f4whodo\fP(1M)
.BT "System Administrator's Reference Manual"
.br
.SH NOTES
Things can change while \f4ps\f1
is running; the picture it gives is only a close approximation to the
current state.
Some data printed for defunct processes is irrelevant.
.P
If no
.I term
or
.I num
is specified,
\f4ps\f1
checks the standard input, the standard output, and
the standard error in that order, looking for the
controlling terminal and will attempt to report on
processes associated with the controlling terminal.
In this situation, if the standard input, the standard
output, and the standard error are all redirected,
\f4ps\f1
will not find a controlling terminal,
so there will be no report.
.P
On a heavily loaded system,
\f4ps\f1
may report an
\f4lseek\f1(2)
error and exit.
\f4ps\f1
may seek to an invalid user area address, having
obtained the address of process' user area,
\f4ps\f1
may not be able to seek to that address before the
process exits and the address becomes invalid.
07070101491081a403012a8a879207ad02f010230root.7/usr/share/man/man1/pseudo.1 .if n .pH 1/gen/pseudo @(#)pseudo 43.3 of 7/20/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990 AT&T
.TH pseudo 1
.SH NAME
\f4pseudo\fP \- \s-1STREAMS\s+1 interface for non-\s-1STREAMS\s+1 devices
.SH SYNOPSIS
.nf
.ft 4
pseudo [\-l] [\-m \f2line\fP]
.ft 1
.fi
.SH DESCRIPTION
The \f4pseudo\fP command provides a \s-1STREAMS\s+1
interface on non-\s-1STREAMS\s+1 tty devices.
It opens a master pseudo-tty device (\f4/dev/ptmx\fP) and
a slave pseudo-tty device (\f4/dev/pts/?\fP).
It pushes the pseudo-terminal emulation module \f4ptem\fP(7),
then a line discipline module, \f4ldterm\fP(7) by default,
onto the slave to connect the master and the slave.
(The stream may be subsequently manipulated with other commands to provide
the desired configuration.)
\f4pseudo\fP then forks to become two processes.
One reads from the user's tty line and writes to the pseudo-tty;
the other reads from the pseudo-tty and writes to the user's tty.
On the pseudo-tty side, a shell is executed.
.P
\f4pseudo\fP accepts the following options:
.IP \f4-l\fP 8n
Execute a ``login shell'' (executed as \f4\-sh\fP).
By default, \f4pseudo\fP executes a simple interactive shell (\f4sh \-i\fP).
.IP "\f4-m\fP \f2line\fP"
Push line discipline module \f2line\fP instead of the default \f4ldterm\fP module.
At most one line discipline is pushed.
.P
The effect of running \f4pseudo\fP is that the user obtains
an interactive shell with the
standard I/O files connected to a \s-1STREAMS\s+1 device that behaves
as a real tty.
This is useful in situations where a \s-1STREAMS\s+1 device is desired
but a non-\s-1STREAMS\s+1 device driver is being used.
.P
When the executed shell exits, \f4pseudo\fP exits and control returns to
the original tty with the original \f4termio\fP(7) parameters.
.SH FILES
.TP 16
\f4/dev/ptmx\fP
pseudo-terminal master device
.TP
\f4/dev/pts/*\fP
pseudo-terminal slave devices
.SH SEE ALSO
\f4ldterm\fP(7),
\f4ptem\fP(7),
\f4pty\fP(7)
07070101492081a403012a8a87970b5e02f010240root.7/usr/share/man/man1/putdgrp.1 .\"macro stdmacro
.if n .pH g1a.putdgrp @(#)putdgrp 43.3 of 6/12/92
.\" Copyright 1991, 1992 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH putdgrp 1M
.SH NAME
\f4putdgrp\fP \- edits device group table
.SH SYNOPSIS
\f4putdgrp\fP [\f4\-d\fP] \f2dgroup\fP [\f2device\fP [\|. . .]\|]
.SH DESCRIPTION
\f4putdgrp\fP
modifies the device group table.
It can modify the table
by creating a new device group or
by removing a device group.
It can also change group definitions by
adding or removing a device from the group definition.
.PP
When \f4putdgrp\fP is executed with only
a \f2dgroup\fP specification, the command
adds the specified group name to the device group
table if it does not already exist.
If the \f4\-d\fP option is
also used with only the \f2dgroup\fP specification, the command
deletes the group from the table.
.PP
When \f4putdgrp\fP is executed with both
a \f2dgroup\fP and a \f2device\fP
specification, it adds the given
device name (or names) to the group definition.
When invoked with both arguments and
the \f4\-d\fP option, the command
deletes the device name (or names) from the group definition.
.PP
When \f4putdgrp\fP is executed with both a
\f2dgroup\fP and a \f2device\fP
specification and the device group does not
exist, it creates the group and
adds the specified devices to that new group.
.SS "Options"
The options and arguments for this command are:
.IP "\f4\-d\fP"
Delete the group or, if used with \f2device\fP, the device
from a group definition.
.IP "\f2dgroup\fP"
Specify a device group name.
.IP "\f2device\fP"
Specify the pathname or alias of the device
that is to added to or deleted
from the device group.
.SS "Return Values"
The command will exit with one of the following values:
.IP "\f40\fP"
Successful completion of the task
.IP "\f41\fP"
Command syntax incorrect, invalid option
used, or internal error occurred.
.IP "\f42\fP"
Device group table could not be opened for
reading or a new device group table
could not be created.
.IP "\f43\fP"
If executed with the \f4\-d\fP option,
indicates that an entry in the device
group table for the device group \f2dgroup\fP
does not exist and so cannot be deleted.
Otherwise, indicates that the
device group \f2dgroup\fP already exists and cannot be added.
.IP "\f44\fP"
If executed with the \f4\-d\fP option,
indicates that the device group
\f2dgroup\fP does not have as members one
or more of the specified devices.
Otherwise, indicates that the device group
\f2dgroup\fP already has one or more
of the specified devices as members.
.SS Files
\f4/etc/dgroup.tab\fP
.SH USAGE
.SS Examples
To add a new device group:
.Ds
\f4 putdgrp floppies\fP
To add a device to a device group:
\f4 putdgrp floppies diskette2\fP
To delete a device group:
\f4 putdgrp -d floppies\fP
To delete a device from a device group:
\f4 putdgrp -d floppies diskette2\fP
.De
.SH REFERENCES
\f4listdgrp\fP(1M),
\f4putdev\fP(1M)
07070101493081a403012a8a8799043f02f010210root.7/usr/share/man/man1/pwck.1 .if n .pH g1a.pwck @(#)pwck 43.3 of 6/18/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pwck 1M
.SH NAME
\f4pwck\f1, \f4grpck\f1 \- password/group file checkers
.SH SYNOPSIS
\f4/usr/sbin/pwck\f1
[\f2file\f1]
.br
\f4/usr/sbin/grpck\f1
[\f2file\f1]
.SH DESCRIPTION
\f4pwck\fP
scans the password file and notes any inconsistencies.
The checks include validation of the number of fields,
login name, user \s-1ID\s+1, group \s-1ID\s+1,
and whether the login directory
and the program-to-use-as-shell exist.
The default password file is
\f4/etc/passwd\f1.
.PP
\f4grpck\fP
verifies all entries in the group file. This verification
includes a check of the number of fields, group name,
group \s-1ID\s+1, whether any login names belong to "
more than \f4NGROUPS_MAX\fP groups
and that all login names appear in the password file.
The default group file is
\f4/etc/group\f1.
.SH FILES
\f4/etc/group\f1
.br
\f4/etc/passwd\f1
.SH SEE ALSO
\f4group\fP(4),
\f4passwd\fP(4)
.SH DIAGNOSTICS
Group entries in
\f4/etc/group\f1
with no login names are flagged.
07070101494081a403012a8a879a082902f010270root.7/usr/share/man/man1/pwck.m.bsd.1 .if n .pH 1m/bsd/pwck @(#)pwck 43.7 of 8/5/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pwck 1M "BSD System Compatibility"
.SH NAME
\f4pwck\f1 \- (\s-1BSD\s+1) check password database entries
.SH SYNOPSIS
\f4/usr/ucb/pwck\f1 [\f2file\f1]
.SH DESCRIPTION
\f4pwck\f1
checks a password file for errors.
If specified,
.I file
is checked, otherwise
\f4/etc/passwd\f1
is checked.
.PP
This command differs from
\f4/usr/sbin/pwck\f1
in its ability to correctly parse
.SM YP
entries in
\f4/etc/passwd\f1.
.SH DIAGNOSTICS
.TP
\f4Too many/few fields\f1
An entry in the password file does not have the proper number of
fields.
.TP
\f4No login name\f1
The login name field of an entry is empty.
.TP
\f4Bad character(s) in login name\f1
The login name in an entry contains
characters other than lowercase letters and digits.
.TP
\f4First char in login name not lower case alpha\f1
The login name in an entry does not begin with a lowercase letter.
.TP
\f4Login name too long\f1
The login name in an entry has more than 8 characters.
.TP
\f4Invalid UID\f1
The user \s-1ID\s+1 field in an entry is not numeric or is greater than
65535.
.TP
\f4Invalid GID\f1
The group \s-1ID\s+1 field in an entry is not numeric or is greater than
65535.
.TP
\f4No login directory\f1
The login directory field in an entry is empty.
.TP
\f4Login directory not found\f1
The login directory field in an entry refers to a directory that does not
exist.
.TP
\f4Optional shell file not found.\f1
The login shell field in an entry refers to a program or shell script that
does not exist.
.TP
\f4No netgroup name\f1
The entry is a Yellow Pages entry referring to a netgroup, but no
netgroup is present.
.TP
\f4Bad character(s) in netgroup name\f1
The netgroup name in a Yellow Pages entry contains characters other than
lowercase letters and digits.
.TP
\f4First char in netgroup name not lower case alpha\f1
The netgroup name in a Yellow pages entry does not begin with a lowercase
letter.
.SH FILES
.PD 0
.TP 20
\f4/etc/passwd\f1
.PD
.SH SEE ALSO
\f4group\fP(4),
\f4passwd\fP(4)
07070101495081a403012a8a879c077202f010230root.7/usr/share/man/man1/pwconv.1 .if n .pH 1m/gen/pwconv @(#)pwconv 43.8 of 8/8/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pwconv 1M
.SH NAME
\f4pwconv\f1 \- install and update \f4/etc/shadow\f1 with information from \f4/etc/passwd\f1
.SH SYNOPSIS
\f4pwconv\f1
.SH DESCRIPTION
The \f4pwconv\fP command
creates and updates
\f4/etc/shadow\f1
with information from
\f4/etc/passwd\f1.
.PP
If the
\f4/etc/shadow\f1
file does not exist,
\f4pwconv\fP creates
\f4/etc/shadow\f1
with information from
\f4/etc/passwd\f1.
The command populates
\f4/etc/shadow\f1
with the user's login name, password,
and password aging information.
If
password aging information does not exist in
\f4/etc/passwd\f1
for a given user, none is added to
\f4/etc/shadow\f1.
However, the last changed information is
always updated.
.PP
If the
\f4/etc/shadow\f1
file does exist, the following tasks are performed:
.IP
Entries that are in the
\f4/etc/passwd\f1
file and not in the
\f4/etc/shadow\f1
file are added to the \f4/etc/shadow\f1 file.
.IP
Entries that are in the
\f4/etc/shadow\f1
file and not in the
\f4/etc/passwd\f1
file are removed from \f4/etc/shadow\f1.
.IP
Password attributes (for example, password and aging information)
in an
\f4/etc/passwd\f1
entry are moved to the corresponding entry in
\f4/etc/shadow.\f1
.PP
The \f4pwconv\fP program
is a privileged system command that cannot be executed by ordinary users.
.SH FILES
\f4/etc/passwd\f1, \f4/etc/shadow\f1, \f4/etc/opasswd\f1, \f4/etc/oshadow\f1
.SH "SEE ALSO"
\f4passwd\fP(1)
.SH DIAGNOSTICS
The
\f4pwconv\f1
command exits with
\f40\f1 on success, or non-zero on one of the following error
conditions:
.P
.PD 0
.IP
\f4Permission denied.\fP
.IP
\f4Invalid command syntax.\fP
.IP
\f4Unexpected failure. Conversion not done.\fP
.IP
\f4Unexpected failure. Password file(s) missing.\fP
.IP
\f4Password file(s) busy. Try again later.\fP
.PD
07070101496081a403012a8a879c034402f01020 root.7/usr/share/man/man1/pwd.1 .if n .pH 1/gen/pwd @(#)pwd 43.2 of 5/20/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH pwd 1
.SH NAME
\f4pwd\f1 \- working directory name
.SH SYNOPSIS
\f4pwd\f1
.SH DESCRIPTION
\f4pwd\fP
prints the path name of the working (current) directory.
.SH FILES
.TP
\f4/usr/lib/locale/\f2locale\f4/LC_MESSAGES/uxcore.abi\f1
language-specific message file [See \f4LANG\fP on \f4environ\f1(5).]
.SH "SEE ALSO"
\f4cd\fP(1)
.SH DIAGNOSTICS
\f4UX:pwd:ERROR: cannot open .
.br
\f4UX:pwd:ERROR: read error in .\f1
.sp .5
indicate possible file system trouble and should be
referred to a UNIX system administrator.
.SH NOTES
If you move the current directory or one above it,
\f4pwd\^\f1
may not give the correct response.
Use the \f4cd\f1(1)
command with a full path name
to correct this situation.
07070101497081a403012a8a879e074302f010210root.7/usr/share/man/man1/quot.1 .if n .pH 1m/gen/quot @(#)quot 43.4 of 7/27/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH quot 1M
.SH NAME
\f4quot\f1 \- summarize \f4ufs\fP file system ownership
.SH SYNOPSIS
\f4/usr/sbin/quot\f1
[
\f4\-acfhnv\f1
] [
.I filesystem . . .
]
.SH DESCRIPTION
.LP
\f4quot\f1
displays the number of blocks (1024 bytes) in the named
.I filesystem
currently owned by each user.
There is a limit of 2048 blocks.
Files larger than this will be counted as a 2048 block file,
but the total blocks count will be correct.
.P
The options are:
.TP
\f4\-a\f1
Generate a report for all mounted file systems.
.TP
\f4\-c\f1
Display three columns giving a file size in blocks, the number of
files of that size, and a cumulative total of blocks
containing files of that size or a smaller size.
Files exceeding 499 blocks are listed as 499 blocks.
The last line always lists 499 blocks,
even if there are no files of that size.
.TP
\f4\-f\f1
Display count of number of files as well as space owned by each user.
This option is incompatible with the \f4-c\fP and \f4-v\fP options.
.TP
\f4\-h\f1
Estimate the number of blocks in the file \(em this
does not account for files with holes in them.
.TP
\f4\-n\f1
Attach names to the list of files read from standard input.
\f4quot -n\fP cannot be used alone, because it expects data
from standard input.
For example, the pipeline
.sp .2
\f4ncheck filesystem | sort +0n | quot \-n filesystem\f1
.sp .2
will produce a list of all files and their owners.
This option is incompatible with all other options.
.TP
\f4\-v\f1
In addition to the default output,
display three columns containing the number of blocks
not accessed in the last 30, 60, and 90 days.
.SH FILES
.PD 0
.TP 20
\f4/etc/mnttab\f1
mounted file systems
.TP
\f4/etc/passwd\f1
to get user names
.PD
.SH "SEE ALSO"
\f4du\fP(1M)
07070101498081a403012a8a879f03e102f010220root.7/usr/share/man/man1/quota.1 .if n .pH 1m/gen/quota @(#)quota 43.7 of 7/27/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH quota 1M
.UC 4
.SH NAME
\f4quota\f1 \- display a user's disk quota and usage on \f4ufs\fP file system
.SH SYNOPSIS
\f4/usr/sbin/quota\f1
[
\f4\-v\f1
] [
.I username
]
.SH DESCRIPTION
\f4quota\f1
displays users' disk usage and limits.
Only a privileged user may use the optional
.I username
argument to view the limits of other users.
.P
\f4quota\f1
without options displays only warnings
about mounted file systems where quotas are turned on and
usage is over quota.
Remotely mounted file systems which
do not have quotas turned on
are ignored.
.P
\f2username\fP can be numeric, corresponding to the
uid of a user.
.P
The
\f4\-v\f1
option displays user's quotas on all mounted
file systems where quotas are turned on.
.SH FILES
.PD 0
.TP 20
\f4/etc/mnttab\f1
list of currently mounted filesystems
.PD
.SH "SEE ALSO"
\f4edquota\fP(1M),
\f4quotaon\fP(1M)
07070101499081a403012a8a87a106e202f010270root.7/usr/share/man/man1/quotacheck.1 .if n .pH 1m/gen/quotacheck @(#)quotacheck 43.5 of 7/27/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH quotacheck 1M
.SH NAME
\f4quotacheck\f1 \- \f4ufs\fP file system quota consistency checker
.SH SYNOPSIS
\f4/usr/sbin/quotacheck\f1
[\f4\-v\f1]
[\f4\-p\f1]
\f2filesystem\f1 .\ .\ .3#
.br
\f4/usr/sbin/quotacheck\f1
\f4-a\fP [\f4\-p\f1] [\f4\-v\f1]
.SH DESCRIPTION
.LP
\f4quotacheck\f1
examines each file system, builds a table of current
disk usage, and compares this table against that stored
in the disk quota file for the file system.
If any inconsistencies are detected, both the quota file
and the current system copy of the incorrect quotas are
updated (the latter only occurs if an active file system
is checked).
.LP
\f4quotacheck\f1
expects each file system to be checked to have a quota
file named
\f4quotas\fP
in the root directory.
If none is present,
\f4quotacheck\f1
will ignore the file system.
.LP
\f4quotacheck\f1
accesses the character special device in calculating the actual disk
usage for each user.
Thus, the file systems checked should be quiescent while
\f4quotacheck\f1
is running.
.P
The options are:
.TP
\f4\-v\f1
Indicate the calculated disk quotas
for each user on a particular file system.
\f4quotacheck\f1
normally reports only those quotas modified.
.TP
\f4\-a\f1
Check the file systems indicated in
\f4/etc/mnttab\f1
to be read-write.
Only those file systems that have "rq"
in the \f4mntopts\fP field of the \f4/etc/vfstab\fP
file are checked.
.TP
\f4\-p\f1
Run parallel passes on the required file systems.
.SH FILES
.PD 0
.TP 20
\f4/etc/mnttab\f1
mounted file systems
.br
.TP 20
\f4/etc/vfstab\f1
list of default parameters for each file system
.PD
.SH "SEE ALSO"
\f4quotaon\fP(1M)
0707010149a081a403012a8a87a2069602f010240root.7/usr/share/man/man1/quotaon.1 .if n .pH 1m/gen/quotaon @(#)quotaon 43.5 of 7/29/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH quotaon 1M
.SH NAME
\f4quotaon\f1, \f4quotaoff\f1 \- turn \f4ufs\fP file system quotas on and off
.SH SYNOPSIS
\f4/usr/sbin/quotaon\f1
[\f4\-v\f1]
\f2filesystem\f1 .\ .\ .
.sp 0.4
\f4/usr/sbin/quotaon\f1
\f4-a\fP [\f4\-v\f1]
\f2filesystem\f1 .\ .\ .
.LP
\f4/usr/sbin/quotaoff\f1
[\f4\-v\f1]
\f2filesystem\f1 .\ .\ .
.sp 0.4
\f4/usr/sbin/quotaoff\f1
\f4-a\fP [\f4\-v\f1]
\f2filesystem\f1 .\ .\ .
.SH "DESCRIPTION"
.LP
\f4quotaon\f1
announces to the system that disk quotas should be
enabled on one or more file systems.
The file systems specified must be mounted at the time.
The file system quota files must be present in the root
directory of the specified file system and be named
\f4quotas\fP.
.LP
\f4quotaoff\f1
announces to the system that file systems specified
should have any disk quotas turned off.
.P
The option for \f4quotaon\fP:
.TP
\f4\-v\f1
Displays a message for each file system where quotas
are turned on.
.P
The option for \f4quotaoff\fP:
.TP
\f4\-v\f1
Displays a message for each file system affected.
.LP
For both \f4quotaon\fP and \f4quoatoff\fP, the option:
.TP
\f4\-a\f1
Reports on all mounted file systems that have \f4rq\fP
in the \f4mntopts\fP field of the \f4/etc/vfstab\fP file.
.LP
These commands
update the status field of devices located in
\f4/etc/mnttab\f1
to indicate when quotas are on or off for each file system.
.SH FILES
.PD 0
.TP 20
\f4/etc/mnttab\f1
mounted file systems
.PD 0
.TP 20
\f4/etc/vfstab\f1
list of default parameters for each file system
.PD
.SH "SEE ALSO"
\f4mnttab\fP(4),
\f4vfstab\fP(4)
0707010149b081a403012a8a87a303db02f010230root.7/usr/share/man/man1/random.1 .if n .pH 1/xnx/random @(#)random 43.4 of 8/4/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH random 1 "XENIX System Compatibility"
.SH NAME
\f4random\fP \- (\s-1XENIX\s+1) generate a random number
.SH SYNOPSIS
\f4random\f1 [\f4-s\f1] [\f2scale\f1]
.SH DESCRIPTION
\f4random\fP generates a random number on the standard
output, and returns the number as its exit value.
By default, this
number is either 0 or 1.
If \f2scale\f1 is given a value between
1 and 255, then the range of the random value is from 0 to \f2scale\f1.
If \f2scale\f1 is greater than 255, an error message is printed.
.P
When the \f4-s\fP (silent) option is given, then the random number is
returned as an exit value, but is not printed on the standard output.
If an error occurs, \f4random\fP returns an exit value of zero.
.SH SEE ALSO
\f4rand\fP(3C)
.SH NOTES
This command does not perform any floating point computations.
\f4random\fP uses the time of day as a seed.
0707010149c081a403012a8a87a60ab402f010220root.7/usr/share/man/man1/rarpd.1 .if n .pH 1m/gen/rarpd @(#)rarpd 43.4 of 6/30/92
.\" Copyright 1992, 1991 UNIX System Laboratories, Inc.
.\" Copyright 1990, 1989 AT&T
.TH rarpd 1M
.SH NAME
\f4rarpd\f1 \- \s-1DARPA\s0 Reverse Address Resolution Protocol server
.SH SYNOPSIS
\f4/usr/sbin/in.rarpd [\-d] \f2device\fP [\f2hostname\fP]
.P
\f4/usr/sbin/in.rarpd -a [\-d]\f1
.SH DESCRIPTION
\f4rarpd\f1
starts a daemon that responds to Reverse Address Resolution Protocol
(\s-1RARP\s0) requests.
The daemon forks a copy of itself that runs in background.
It must be run as root.
.P
\s-1RARP\s0 is used by machines at boot time to discover their
Internet Protocol (\s-1IP\s0) address.
The booting machine provides its Ethernet Address in
a
.SM RARP
request message.
Using the \f4ethers\f1 and \f4hosts\f1 databases,
\f4rarpd\f1
maps this Ethernet Address into the corresponding IP address
which it returns to the booting machine in an RARP reply message.
The booting machine must be listed in both databases for
\f4rarpd\f1
to locate its IP address.
\f4rarpd\f1
issues no reply when it fails to locate an IP address.
.P
In the first synopsis, the
.I device
parameter names the network interface upon which
\f4rarpd\f1
is to listen for requests.
The
.I device
parameter takes the ``name unit'' form used by
\f4ifconfig\f1(1M).
The second argument,
.IR hostname ,
is used to obtain the IP address of that interface.
An IP address in ``decimal dot'' notation may be used for
.IR hostname .
If
.I hostname
is omitted, the address of the interface will be obtained from the kernel.
When the first form of the command is used,
\f4rarpd\f1
must be run separately for each interface
on which \s-1RARP\s0 service is to be supported.
A machine that is a router may invoke
\f4rarpd\f1
multiple times, for example:
.P
.RS
\f4/usr/sbin/in.rarpd wd0 host\f1
.br
\f4/usr/sbin/in.rarpd wd1 host-backbone\f1
.RE
.P
In the second synopsis, the \f4\-a\f1 option of
\f4rarpd\f1
locates all of the network interfaces present on the system
and starts a daemon process for each one that supports \s-1RARP\s0.
.P
The \f4\-d\f1 option (valid for both synopsis entries) turns on debugging, and
debugging information is printed to "standard error" (\f4stderr\f1).
.SH "FILES"
.PD 0
.TP 20
\f4/etc/ethers\f1
.\" .TP
.\" .BI /var/yp/ domainname /ethers.byaddr.*
.\" .TP
.\" .BI /var/yp/ domainname /ethers.byname.*
.TP
\f4/etc/hosts\f1
.\" .TP
.\" .BI /var/yp/ domainname /hosts.byname.*
.PD
.SH "SEE ALSO"
\f4boot\f1(1M),
\f4ethers\f1(4),
\f4hosts\f1(4),
\f4ifconfig\f1(1M),
\f4netconfig\f1(4)
.P
Finlayson, Ross, Timothy Mann, Jeffrey Mogul, and Marvin Theimer,
.IR "A Reverse Address Resolution Protocol" ,
.SM RFC
903,
Network Information Center,
.SM SRI
International, Menlo Park, Calif.,
June 1984
0707010149d081a403012a8a87a80e7702f01020 root.7/usr/share/man/man1/rc0.1 '\"macro stdmacro
.if n .pH g1a.rc0 @(#)rc0 43.3 of 6/15/92
.\" Copyright 1991 UNIX System Laboratories, Inc.
.\" Copyright 1989, 1990 AT&T
.TH rc0 1M
.SH NAME
\f4rc0\fP, \f4rc6\fP \- run commands performed to stop the operating system
.SH SYNOPSIS
\f4/sbin/rc0\f1 [\f4firmware\f1 | \f4off\f1 | \f4reboot\f1 ]
.br
\f4/sbin/rc6\f1 [\f4firmware\f1 | \f4off\f1 | \f4reboot\f1 ]
.SH DESCRIPTION
\f4rc0\fP is executed at each system state change that needs to have the
system in an inactive state.
It is responsible for those actions that bring the system to a quiescent state,
traditionally called ``shutdown''.
(For backwards compatibility, \f4/sbin/rc0\f1 is linked to \f4/sbin/rc6\fP.)
.PP
Three system states require this procedure:
state \f40\f1,
state \f45\f1,
and
state \f46\f1.
Whenever a change to one of these states occurs, the
\f4rc0\f1
procedure is run.
The options are used as follows:
.PP
.RS
.IP \f4firmware\fP 14n
Go to init state 5 (the firmware state)
.IP \f4off\fP
Go to init state 0 (the system halt state)
.IP \f4reboot\fP
Go to init state 6 (the reboot state)
.RE
.PP
The entries in
\f4/etc/inittab\f1, which may vary slightly
on different machine types,
might read something like this:
.P
.RS
.nf
\f4r0:0:wait:/sbin/rc0 off 1>/dev/sysmsg 2>&1 /dev/sysmsg 2>&1 /dev/sysmsg 2>&1