HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)

s
strchg(1M) strchg(1M)
NAME
strchg, strconf - change or query stream configuration
SYNOPSIS
strchg -h module1[, module2]...
strchg -p [ -a-u module]
strchg -f file
strconf
strconf -t
strconf -m
module
DESCRIPTION
The strchg and strconf commands are used to change or query the configuration of the stream associ-
ated with the user’s standard input. The
strchg command pushes modules on and/or pops modules off
the stream. The
strconf command queries the configuration of the stream. Only the superuser or
owner of a STREAMS device may alter the configuration of that stream.
strchg Options
The strchg command uses the following options:
-h module1[,module2] ...
strchg pushes modules onto a stream. The modules are pushable STREAMS
modules as defined by module1, module2, and so on. The modules are pushed in
order. That is, module1 is pushed first, module2 is pushed second, etc.
-p With the -p option alone, strchg pops the topmost module from the stream.
-a With the -p and -a options, all the modules above the topmost driver are popped.
-u module With the -p and -u module options, all modules above but not including module are
popped off the stream.
The -a and -u options are mutually exclusive.
-f file The user can specify a file that contains a list of modules representing the desired
configuration of the stream. Each module name must appear on a separate line where
the first name represents the topmost module and the last name represents the
module that should be closest to the driver. The strchg command will determine
the current configuration of the stream and pop and push the necessary modules in
order to end up with the desired configuration.
The -h, -f, and -p options are mutually exclusive.
strconf Options
Invoked without any arguments, strconf prints a list of all the modules in the stream as well as the top-
most driver. The list is printed in one name per line where the first name printed is the topmost module on
the stream (if one exists) and the last item printed is the name of the driver.
The strconf command uses the following options:
-t Only the topmost module (if one exists) is printed.
-m module strconf checks if the named module is present on the stream. If so, strconf prints
the message, yes, and returns zero. If not, strconf prints the message, no, and
returns a non-zero value.
The -t and -m options are mutually exclusive.
Notes
If the user is neither the owner of the stream nor the superuser, the strchg command will fail. If the
user does not have read permissions on the stream and is not the superuser, the strconf command will
fail.
If modules are pushed in the wrong order, one could end up with a stream that does not function as
expected. For ttys, if the line discipline module is not pushed in the correct place, one could have a termi-
nal that does not respond to any commands.
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 411