autopush man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]


       autopush - configures lists of automatically pushed STREAMS modules

       autopush -f filename

       autopush -g -M major -m minor

       autopush -r -M major -m minor

       The autopush command configures the list of modules to be automatically
       pushed onto the stream when a device is opened. It can also be used  to
       remove a previous setting or get information on a setting.

       The following options are supported:

       -f filename

	   Sets up the autopush configuration for each driver according to the
	   information stored in filename. An autopush file consists of	 lines
	   of four or more fields, separated by spaces as shown below:

	     major minor last-minor module1 module2 ... module8

	   The	first  field is a string that specifies the major device name,
	   as listed in the /kernel/drv directory. The	next  two  fields  are
	   integers that specify the minor device number and last-minor device
	   number.  The fields following represent the names  of  modules.  If
	   minor  is −1, then all minor devices of a major driver specified by
	   major are configured, and the value for last-minor is  ignored.  If
	   last-minor  is 0, then only a single minor device is configured. To
	   configure a range of minor devices for a  particular	 major,	 minor
	   must be less than last-minor.

	   The	remaining fields list the names of modules to be automatically
	   pushed onto the stream when opened, along with the position	of  an
	   optional  anchor.  The maximum number of modules that can be pushed
	   is eight. The modules are pushed in the order they  are  specified.
	   The	optional  special character sequence [anchor] indicates that a
	   STREAMS anchor should be placed on the stream at the module	previ‐
	   ously  specified  in	 the list; it is an error to specify more than
	   one anchor or to have an anchor first in the list.

	   A nonzero exit status indicates that one or more of	the  lines  in
	   the specified file failed to complete successfully.


	   Gets	 the  current  configuration setting of a particular major and
	   minor device number specified with the -M and  -m  options  respec‐
	   tively  and	displays  the  autopush modules associated with it. It
	   will also return the starting minor device number  if  the  request
	   corresponds	to  a  setting	of  a  range (as described with the -f

       -m minor

	   Specifies the minor device number.

       -M major

	   Specifies the major device number.


	   Removes the previous configuration setting of the particular	 major
	   and	minor  device  number  specified  with	the  -M and -m options
	   respectively. If the values of major and minor correspond to a pre‐
	   viously  established	 setting  of  a	 range of minor devices, where
	   minor matches the first minor device number in the range, the  con‐
	   figuration would be removed for the entire range.

       The following exit values are returned:


	   Successful completion.


	   An error occurred.

       Example 1 Using the autopush command.

       The  following  example gets the current configuration settings for the
       major and minor device numbers as indicated and displays	 the  autopush
       modules	 associated   with   them  for	the  character-special	device

	 example# autopush -g -M 29 -m 0
	 Major	   Minor     Lastminor	   Modules
	   29	     0	       1	   ldterm  ttcompat


       dladm(1M),    ttymon(1M),    attributes(5),    ldterm(7M),     sad(7D),
       streamio(7I), ttcompat(7M)

       The  use of the autopush command is obsolete for networking data-links.
       The preferred method of configuring  a  list  of	 automatically	pushed
       STREAMS	modules	 on  a	given  networking  data-link  interface is the
       dladm(1M) autopush link property.

       Because network devices are self-cloning, the autopush command is inad‐
       equate  for  networking	devices.  The granularity of the autopush com‐
       mand's configuration is driver-wide, and not per-interface as one might
       expect.	Another	 reason not to use autopush is that administrators are
       more familiar with the names of	their  network	interfaces  than  with
       device  major  and minor numbers. The dladm(1M) command allows the con‐
       figuration using data-link interface names.

				 Feb 15, 2008			  AUTOPUSH(1M)

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net