'\"macro stdmacro
.if n .pH g8.ports @(#)ports	40.5 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} ports 8 "" "\&"
.if \nX=1 .ds x} ports 8 ""
.if \nX=2 .ds x} ports 8 "" "\&"
.if \nX=3 .ds x} ports "" "" "\&"
.TH \*(x}
.SH NAME
\f4ports\f1 \- create character device files and \f4inittab\fP entries for ports boards 
.SH SYNOPSIS
\f4/sbin/ports\f1
.SH DESCRIPTION
The \f4ports\fP command creates character device files in
\f4/dev\f1 and adds new entries in \f4/sbin/inittab\f1
for 4 asynchronous RS-232 ports and 1 parallel printer port.
A port is named
\f4tty\f2sn\f1,
where
.I s
is the slot number and
.I n
is a number from 1 to 5.
.PP
If the board configuration has changed,
\f4ports\fP does the following:
.IP
Remove any tty device files for a board that no longer resides in a slot.
.IP
Remove device files of other boards such as the NI if a ports board now resides
in the slot that previously held an NI.
A message warning that a device file is being removed is sent to the console.
.IP
Make new tty device files for the ports boards if needed.
.IP
Make new \f4inittab\fP entries for the ports boards.
.PP
If the configuration has not changed,
the ports program exits without doing anything.
.PP
Any devices,
such as a printer or a modem,
that are added to a ports board
should link the names that are to be used for the devices
to the corresponding tty device files that were created
[see \f4ln\fP(1)].
The command can be used only by the super-user.
.SH EXAMPLE
A parallel printer is added to a ports board that is in slot 1.
The corresponding slot is \f4tty15\fP.
The user should use
\f4ln\fP
to link an appropriate name such as \f4lp1\fP to the tty device file.
.P
.RS
\f4ln /dev/tty15 /dev/lp1\f1
.RE
.SH FILES
\f4/sbin/inittab\fP
.br
\f4/dev/tty\f2sn\f1
.SH SEE ALSO
\f4ln\fP(1) in the
.I "User's Reference Manual"
.SH NOTES
A warning is issued for each device file that is removed provided it is
not a tty device file.
If a ports board has been removed and \f4lp1\fP has been linked to a tty
device file, the message is as follows:
.P
.RS
.nf
.ft 5
Warning: /dev/lp1 is being removed.
.ft 1
.fi
.RE
.Ee
