strsetup.conf(4)strsetup.conf(4)NAMEstrsetup.conf - Configuration file for STREAMS drivers
DESCRIPTION
The /etc/strsetup.conf file is the configuration file for STREAMS driv‐
ers. The strsetup.conf file specifies one or more character special
files (or nodes) to be created when a STREAMS driver is configured into
the kernel. If the driver is not configured, no character special
files are created for it. If an old version of the file exists, the
strsetup command removes it before the new one is created.
The /etc/strsetup.conf file is defined as a Context-Dependent Symbolic
Link (CDSL), and must be maintained as such. See the System Adminis‐
tration manual for more information.
Each entry in the /etc/strsetup.conf file specifies a driver name,
device special file name, file mode and minor number. See the EXAMPLES
section for a sample strsetup.conf file.
Each line in the file is of the form:
driver_name filename file_mode minor_number
The fields have the following meanings: Specifies the name of the
driver as reported by the strsetup -c command. This field is used to
match the names read by the strsetup command from the kernel and must
match exactly (the match is case sensitive). Specifies the full path
name of the character special file or files to be created when
driver_name is configured into the kernel. The filename can contain
one conversion specifier in the style of printf(3). This conversion is
used to include a minor device number in the filename. The permitted
conversions are the following: Prints the minor number as a signed dec‐
imal Prints the minor number as a hexadecimal with lower case letters
Prints the minor number hexadecimal with uppercase letters Prints octal
Prints the minor number as an unsigned decimal Prints the minor number
as a signed decimal
Note that you must use a double percent sign (%%) to include a percent
sign in the filename. Optionally, each of these conversions can
include a specification for some number of leading 0's.
This is done by following the % with a 0 and one or more digits speci‐
fying the total number of digits to be printed. The 0 must appear
after the %. See the printf(3) reference page for more information.
Any directories in the path of the filename that do not exist are cre‐
ated. Specifies the file mode assigned to the file when it is created.
The file_mode field must always be in octal. The file is always cre‐
ated as a character special file. Specifies the minor device number
field. The strsetup command reads the major device numbers from the
kernel. This field indicates to the strsetup command how to assign
minor device numbers. This minor_number field can contain the one of
the following values: Indicates that the device should be created as a
clone device. In this case the major number becomes that of the spe‐
cial clone pseudo-device driver and the minor device number becomes the
device's major number. Note that the word clone must be lowercase.
Creates a single device with the minor device number N. Note that N is
a decimal number. Create M-N nodes with the devices' major numbers and
minor numbers between M and N. Note that M and N are decimal numbers.
When a range of minor numbers is specified, a filename conversion spec‐
ifier can be used to make certain that each node created is unique.
EXAMPLES
The following is a sample /etc/strsetup.conf file:
special driver name filename file
mode minor number ptm /dev/ptmx 0666
clone log /dev/streams/log 0666 clone
nuls /dev/streams/nuls 0666 clone echo
/dev/streams/echo 0666 clone sad
/dev/sad/admin 0666 clone pts
/dev/pts/%d 0666 0-127
FILES
STREAMS setup configuration file
RELATED INFORMATION
Commands: strsetup(8)
Network Programmer's Guide delim off
strsetup.conf(4)
