Manual page for ports(1M)
ports - create /dev entries and inittab entries for serial lines
SYNOPSIS
/usr/sbin/ports
[
-r rootdir
]
AVAILABILITY
SUNWcsu
DESCRIPTION
The
ports
command creates symbolic links from
/dev/term
and
/dev/cua
to the serial-port character device files in
/devices
and adds new entries in
/etc/inittab
for non-system ports found.
System-board ports are given single lower-case letters for names
(such as
a
and
b)
while other ports are named numerically.
ports
searches the kernel device tree to find the serial devices attached to
the system. It also checks
/dev/term
and
/dev/cua
to see what symbolic links to serial devices already exist.
ports
then performs the following:
-
- 1.
-
Assigns new numbers (or letters for system-board ports) to ports that
are attached to the system but do not have
/dev/term
and
/dev/cua
entries.
The numbers or letters assigned are the
lowest-unused numbers or letters.
- 2.
-
Removes dangling links:
links from
/dev/term
and
/dev/cua
pointing to no-longer-existing ports.
- 3.
-
Creates new
/dev/term
and
/dev/cua
links for new serial devices.
- 4.
-
Invokes
sacadm.1m
to make new port monitor entries for the new devices.
This is not done automatically for on-board ports;
on workstations
these ports are often not used for dial-in sessions,
so a port-monitor for one of these ports must be created explicitly.
If the configuration has not changed,
ports
exits without doing anything.
Of interest to device driver writers are the devices that
ports
considers serial devices.
Device nodes of type
DDI_NT_SERIAL,
DDI_NT_SERIAL_MB,
DDI_NT_SERIAL_DO,
and
DDI_NT_SERIAL_MB_DO
are considered serial devices (see
ddi_create_minor_node.9f
for more information on node types).
OPTIONS
- -r rootdir
-
Cause
ports
to presume that the
/dev/term,
/dev/cua,
and
/devices
directories are found under
rootdir,
not directly under
/.
If this argument is specified,
sacadm.1m
is not invoked, since it would update terminal
administration files under
/etc
without regard to the
rootdir.
FILES
- /dev/term/n
-
- /dev/cua/n
-
- /etc/inittab
-
- /etc/saf/*
-
SEE ALSO
devlinks.1m
disks.1m
pmadm.1m
sacadm.1m
tapes.1m
ddi_create_minor_node.9f
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97
