unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 autopush(1M)							autopush(1M)




 NAME
      autopush - manage system database of automatically pushed STREAMS
      modules

 SYNOPSIS
      autopush -f file

      autopush -g -M major -m minor

      autopush -r -M major -m minor

 DESCRIPTION
      autopush manages the system database that is used for automatic
      configuration of STREAMS devices.	 The command is used in three
      different ways as dictated by the -f, -g, and -r command-line options
      described below.

    Options
      autopush recognizes the following command-line options and arguments:

	   -f file	  Using the configuration information contained in
			  file, load the system database with the names of
			  the STREAMS devices and a list of modules to use
			  for each device.  When a device is subsequently
			  opened, the HP-UX STREAMS subsystem pushes the
			  modules onto the stream for the device.

			  file must contain one or more lines of at least
			  four fields separated by a space as shown below:

			  major minor lastminor module1 module2 ... moduleN

			  The first field major can be either an integer or
			  a device name.  The device name is the name for
			  the device used in the master file.  The next two
			  fields are integers.	If minor is set to -1, then
			  all minor devices for the specified major are
			  configured and lastminor is ignored.	If lastminor
			  is 0, then only a single minor device is
			  configured. To configure a range of minor devices
			  for a major device, minor must be less then
			  lastminor.  The remaining field(s) list one or
			  more module names.  Each module is pushed in the
			  order specified. A maximum of eight modules can be
			  pushed.  Any text after a # character in file is
			  treated as a comment for that line only.

			  This option is also used to restore device
			  configuration information previously removed by
			  autopush -r.	However, when used in such a manner,
			  the entire database is restored, not just the



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 autopush(1M)							autopush(1M)




			  information that was previously removed.

	   -g -M major -m minor
			  Display current configuration information from the
			  system database for the STREAMS device specified
			  by the major device number (or device name for the
			  device from the master file) and minor number.

			  If a range of minors has been previously
			  configured then autopush -g returns the
			  configuration information for the first minor in
			  the range, in addition to other information.

	   -r -M major -m minor
			  Remove configuration information from the system
			  database for the STREAMS device specified by the
			  major device number (or device name for the device
			  from the master file and minor number.  Removal is
			  performed on the database only, not on the
			  original configuration file.	Therefore, the
			  original configuration can be restored by using
			  the -f file option.  To permanently exclude a
			  STREAMS device from the database, its information
			  must be removed from the configuration file.

			  If minor matches the first minor of a previously
			  configured range then autopush -r removes the
			  configuration information for the entire
			  configured range.

 EXAMPLES
      If the file /tmp/autopush.example contains:

	   75 -1 0 modA modB
	   test 0 5 modC modA

      Then autopush -f /tmp/autopush.example will cause modA and modB to be
      pushed whenever major device # 75 is opened, and modC and modA to be
      pushed for the first six opens of device test.

      This next example lists information about the stream for major device
      75 and its minor device -2:

	   autopush -g -M 75 -m -2

 FILES
      /usr/lib/nls/msg/C/autopush.cat			NLS catalog for
							autopush.

 SEE ALSO
      sad(7), streamio(7).



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000