Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
insf(1M)							      insf(1M)

NAME
       insf - install special (device) files

SYNOPSIS
       class | driver] directory] hw-path] instance] npty] nstrpty]

DESCRIPTION
       The  command  installs special files in the devices directory, normally
       If required, creates any	subdirectories that are	defined	 for  the  re-
       sulting special file.

       If  no options are specified, special files are created for all new de-
       vices in	the system.  New devices are those devices for which  no  spe-
       cial  files  have been previously created.  A subset of the new devices
       can be selected with the	and options.

       With the	option,	reinstalls the special files  for  pseudo-drivers  and
       existing	 devices.  This	is useful for restoring	special	files when one
       or more have been removed.

       Normally, displays a message as the special  files  are	installed  for
       each  driver.   The (quiet) option suppresses the installation message.
       The (verbose) option displays the installation message and the name  of
       each special file as it is created.

   Options
       recognizes the following	options.

	      Match devices that belong	to a given device class,
			     class.   Device  classes  can  be listed with the
			     command (see lsdev(1M)).  They are	defined	in the
			     files in the directory The	special	class includes
			     all pseudo-drivers.  This option cannot  be  used
			     with

	      Match  devices  that  are	 controlled  by	 the  specified	device
	      driver,
			     driver.  Device drivers can be  listed  with  the
			     command (see lsdev(1M)).  They are	defined	in the
			     files in the directory This option	cannot be used
			     with

	      Override the default device installation directory
			     and  install  the	special	files in directory in-
			     stead.  directory must exist; otherwise, displays
			     an	error message and exits.  See WARNINGS.

	      Reinstall	 the special files for pseudo-drivers and existing de-
	      vices.
			     This is useful for	restoring special files	if one
			     or	more have been removed.

	      Match devices at a given hardware	path,
			     hw-path.	Hardware  paths	can be listed with the
			     command (see ioscan(1M)).	A hardware path	speci-
			     fies  the	addresses  of  the hardware components
			     leading to	a device.  It consists of a string  of
			     numbers separated by periods such as (a card), (a
			     target address), and (a device).  If  a  hardware
			     component	is  a bus converter, the following pe-
			     riod, if any, is replaced by a slash as in	and

			     If	the specified path contains fewer numbers than
			     are  necessary  to	 reach a device, special files
			     are made for all devices at addresses that	extend
			     the  given	 path.	 If the	specified path is then
			     special files are made for	 the  devices  at  ad-
			     dresses etc.

	      Match a device with the specified
			     instance  number.	 Instances  can	be listed with
			     the option	of the command (see ioscan(1M)).

			     This option is effective only if  the  option  is
			     specified	or  if	an appropriate device class or
			     driver is specified with a	or option.

	      Install	     npty special files	for each specified and driver.
			     The  driver specifies both	the and	drivers.  npty
			     is	a decimal number.

			     This option is effective only if  the  option  is
			     specified	or  if	an appropriate device class or
			     driver is specified with a	or option.

			     If	this option is omitted,	npty  defaults	to  60
			     for the and drivers.

	      Install the special files	for those optical disks
			     located  in slots in the range first-optical-disk
			     to	last-optical-disk.  The	two variables can have
			     values from the set ..., This option only applies
			     to	the and	drivers.  If it	 is  omitted,  the  64
			     special  files for	both sides of 32 optical disks
			     through will be installed.

	      Quiet option.  Normally, displays	a message as  each  driver  is
			     processed.	  This	option	suppresses  the	driver
			     message, but not error messages.  See the option.

	      Install	     nstrpty slave-side	stream special files  for  the
			     driver.   nstrpty	is a decimal number.  This op-
			     tion only applies to the special  file  installa-
			     tion.

			     This  option  is  effective only if the option is
			     specified or if an	appropriate  device  class  or
			     driver is specified with a	or option.

			     If	 this  option  is omitted, nstrpty defaults to
			     60.

	      Verbose option.
			     In	addition to  the  normal  processing  message,
			     display  the  name	 of each special file as it is
			     created.  See the option.

   Naming Conventions
       Many special files are named using the naming convention.  These	 vari-
       ables have the following	meaning	wherever they are used.

	      card	The  unique  interface card identification number from
			(see ioscan(1M)).  It is represented as	a decimal num-
			ber with a typical range of 0 to 255.

	      target	The device target number, for example the address on a
			HP-FL or SCSI bus.  It is  represented	as  a  decimal
			number with a typical range of 0 to 15.

	      device	A  address unit	within a device, for example, the unit
			in a HP-FL device or the LUN in	a SCSI device.	It  is
			represented  as	 a decimal number with a typical range
			of 0 to	15.

   Special Files
       This subsection shows which special files are created and  the  permis-
       sions for each device driver.

       The special file	names are relative to the installation directory, nor-
       mally This directory may	be overridden with the option.

       sets the	file permissions and the owner and group IDs.  They are	 shown
       here in a format	similar	to that	of the command:

		       special-file	   permissions owner group

       For example:

       The following special file is installed:

       For  the	 built-in  serial port,	the following special files are
       installed for
	      each card	instance:

						Direct connect

       For the SAS console ports, the following	special	 files	are  installed
       for
	      each card	instance:

						local	console	 port  (direct
						connect)

						remote	session	 port  (direct
						connect)

						internal  console port (direct
						connect)

						UPS port (direct connect)

						local  session	port   (direct
						connect)

       The following special file is installed:

       The following special files are installed.
	      Note the underscore before card in each special file name.

	      For  card	 0,  the  device files are linked to files without the
	      trailing in their	names.

						Default	audio device

						Audio control device

						All outputs, A-law format

						All  outputs,  16-bit	linear
						format

						All outputs, Mu-law format

						External output, A-law format

						External output, 16-bit	linear
						format

						External output, Mu-law	format

						Internal speaker output, A-law
						format

						Internal    speaker    output,
						16-bit linear format

						Internal speaker  output,  Mu-
						law format

						Line output, A-law format

						Line  output,  16  bit	linear
						format

						Line output, Mu-law format

						No output, A-law format

						No output, 16 bit linear  for-
						mat

						No output, Mu-law format

       Special file names for
	      and use the format:

	      surface: through unless modified by the option.  Note the	under-
	      score between device and surface.

	      For each autochanger device, the following special files are in-
	      stalled:

							       Block entry

							       Character entry

							       Character entry

       The following special file is installed:

       For each	card instance, the following special file is installed.

							  Handshake   mode  2,
							  character entry

       For each	card instance, the following special files are installed:

						Direct connect

       The following special files are installed:

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       The following special files are installed:

       For each	disk device, the following special files are installed:

							       Block entry

							       Character entry

	      For disc3	instances, the following additional special files  are
	      installed:

							       Block entry

							       Character entry

	      For  disk	 instances  that  are partitioned, the following addi-
	      tional special files are installed:

							       Block entry

							       Character entry

       The following special files are installed:

       The following special file is installed:

       The following special file is installed:

       For each	instance of an EISA mux	or PCI mux card,
	      the following "Direct Connect" special files are	created.   The
	      term "card" below	refers to the instance number of the mux card.

						letter:
				  to port module name
				  port:	to direct connect

       The following special file is installed:

       For  each  graphics  device, the	following special files	are in-
       stalled.

		     device_number
	      is 0 indexed and is assigned in the order	in which  the  devices
	      appear in	ioscan(1M) output.

	      If  the  console	device is a graphics device, the files and are
	      created as the console device.  If the console is	not a graphics
	      device, and are identical	to and

       For each	device,	the following special files are	installed.
	      Note the underscore before card in each special file name.

	      For  card	 0, the	device files are linked	to files named for the
	      link addresses 1 to 7; for the cooked keyboard device;  and  for
	      the controller device.

						addr:
				  link addresses to

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       For  each  card	instance,  the	following special files	are in-
       stalled:

       For each	card instance, the  following  special	files  are  in-
       stalled:

							  Normal access

							  Exclusive access

       For each	card instance, the following special files are installed:

       The following special files are installed:

						Minor

						Minor

						Minor

       For each	instance of a 6-channel	card,
	      the following special files are installed:

						port:
				  to direct connect

						For   each   instance	of   a
						16-channel card,
				  the following	special	files are installed:

						port:
				  to direct connect

       For each	instance of an 16-channel card,
	      the following special files are installed:

						port:
				  to direct connect

						For each card instance	of  an
						8-channel card,
				  the following	special	files are installed:

						port:
				  to direct connect

						For  each  card	instance of an
						3-channel card,
				  the following	special	files are installed:

						port:
				  and direct connect

       For each	card instance,
	      the following special files are installed:

						port:
				  and direct connect

       The following special file is installed:

       The following special file is installed:

       The following "Direct Connect" special files are	created.
	      The term "card" below refers to the instance number of  the  mux
	      card.

						port_module:
				  to port module name
				  port:	to port	number

       For  each  card	instance,  the	following special files	are in-
       stalled:

							       Block entry

							       Character entry

       The following special files are installed:

						Autosearch for first ps2  key-
						board

						Autosearch for first ps2 mouse

						ps2 port 0

						ps2 port 1

       The following special file is installed:

       The following special files are installed:

						number:
				  to

       Specifying this driver tells
	      to  install  the special files for both the master and slave pty
	      drivers, and The command is equivalent to	the two	commands and

       The following special files are installed:

							  index:
					    to to to number: to	(hexadecimal)

					    The	first  48  special  files  are
					    linked to

							  index:
					    to to to number: to

							  index:
					    to to to number: to

       The following special files are installed:

							  index:
					    to to to number: to	(hexadecimal)

					    The	 first	48  special  files are
					    linked to

							  index:
					    to to to number: to

							  index:
					    to to to number: to

       The following special file is installed:

       The following special files are installed:

       The following special file is installed:

       For each	card instance, the  following  special	files  are  in-
       stalled:

						port:
				  to direct connect

       See

       See

       See

       For each	driver instance, different special files are installed
	      depending	 on the	number of characters allowed in	the target di-
	      rectory.	There are two lists below, one for long	file name  di-
	      rectories	and one	for short file name directories	(14 characters
	      maximum).	 Short file names are used for files installed	on  an
	      NFS file system.

	      Note  that  the  first  four special files in each list for tape
	      driver instances 0-9 are also linked to and respectively.

	      For installation in a long file name directory:

							       AT&T-style,
							       best  available
							       density,	 char-
							       acter entry

							       Berkeley-style,
							       best  available
							       density,	 char-
							       acter entry

							       AT&T-style,  no
							       rewind,	  best
							       available  den-
							       sity, character
							       entry

							       Berkeley-style,
							       no rewind, best
							       available  den-
							       sity, character
							       entry

	      For installation in a short file name directory:

							       AT&T-style,
							       best  available
							       density,	 char-
							       acter entry

							       Berkeley-style,
							       best  available
							       density,	 char-
							       acter entry

							       AT&T-style,  no
							       rewind,	  best
							       available  den-
							       sity, character
							       entry

							       Berkeley-style,
							       no rewind, best
							       available  den-
							       sity, character
							       entry

	      For both long and	short file name	directories, the following ad-
	      ditional files are created.

							       Tape configura-
							       tion, character
							       entry

							       For
						 only,	  diagnostic   access,
						 character entry

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       See

       The following special file is installed:

       The following special file is installed:

       The following special files are installed:

						number:
				  to

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       The following special file is installed:

       RETURN VALUE
	      exits with one of	the following values:

	      Successful completion, including warning diagnostics.
	      Failure.

DIAGNOSTICS
       Most diagnostic messages	from are self-explanatory.  Listed  below  are
       some messages deserving further clarification.

   Warnings
		     The  indicated  device  driver  or	 device	 class	is not
		     present in	the kernel.
	      A	device driver and/or device class can be added to  the	kernel
	      using config(1M).

	      All  of  the instance numbers available for the device class are
	      already assigned.	 Use the command to remove  any	 unneeded  de-
	      vices from the system (see rmsf(1M)).

	      does  not	know how to create special files for the specified de-
	      vice driver.  Use	to create special files	for  the  device  (see
	      mknod(1M)).

EXAMPLES
       Install	special	 files	for  all  new  devices belonging to the	device
       class:

       Install special files to	the new	device added at	hardware path

WARNINGS
       should only be run in single-user mode.	It can change the mode,	owner,
       or  group of an existing	special	file, or unlink	and recreate one; spe-
       cial files that are currently open may  be  left	 in  an	 indeterminate
       state.

       Many commands and subsystems assume their device	files are in therefore
       the use of the option is	discouraged.

AUTHOR
       was developed by	HP.

FILES
       I/O system special file

       I/O system configuration	database

SEE ALSO
       config(1M),  ioscan(1M),	 lsdev(1M),  lssf(1M),	mknod(1M),   mksf(1M),
       rmsf(1M).

								      insf(1M)

NAME | SYNOPSIS | DESCRIPTION | DIAGNOSTICS | EXAMPLES | WARNINGS | AUTHOR | FILES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=insf&sektion=1m&manpath=HP-UX+11.22>

home | help