[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    ports(1M) manual page Table of Contents

Name

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. .
  3. Removes dangling links: links from /dev/term and /dev/cua pointing to no-longer-existing ports.
  4. .
  5. Creates new /dev/term and /dev/cua links for new serial devices.
  6. .
  7. 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)


Table of Contents