share/man/man8/drvconfig.8

   1 '\" te
   2 .\" Copyright (c) 2002 Sun Microsystems, Inc. All
   3 .\" Rights Reserved.
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH DRVCONFIG 8 "Aug 9, 2004"
   8 .SH NAME
   9 drvconfig \- apply permission and ownership changes to devices
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBdrvconfig\fR [\fB-bn\fR] [\fB-a\fR \fIalias_name\fR] [\fB-c\fR \fIclass_name\fR]
  14      [\fB-i\fR \fIdrivername\fR] [\fB-m\fR \fImajor_num\fR] [\fB-r\fR \fIroot_dir\fR]
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 \fBdevfsadm\fR(8) is now the preferred command and should be used instead of
  21 \fBdrvconfig\fR.
  22 .sp
  23 .LP
  24 The default operation of \fBdrvconfig\fR is to apply permission and ownership
  25 changes to devices. Normally, this command is run automatically after a new
  26 driver has been installed (with \fBadd_drv\fR(8)) and the system has been
  27 rebooted.
  28 .SH OPTIONS
  29 .sp
  30 .LP
  31 The following options are supported:
  32 .sp
  33 .ne 2
  34 .na
  35 \fB\fB-a\fR\fIalias_name\fR\fR
  36 .ad
  37 .RS 16n
  38 Add the name \fIalias_name\fR to the list of aliases that this driver is known
  39 by. This option, if used, must be used with the \fB-m\fR \fImajor_num\fR, the
  40 \fB-b\fR and the \fB-i\fR \fIdrivername\fR options.
  41 .RE
  42
  43 .sp
  44 .ne 2
  45 .na
  46 \fB\fB-b\fR\fR
  47 .ad
  48 .RS 16n
  49 Add a new major number to name binding into the kernel's internal
  50 \fBname_to_major\fR tables. This option is not normally used directly, but is
  51 used by other utilities such as \fBadd_drv\fR(8). Use of the \fB-b\fR option
  52 requires that \fB-i\fR and \fB-m\fR be used also. No \fB/devices\fR entries are
  53 created.
  54 .RE
  55
  56 .sp
  57 .ne 2
  58 .na
  59 \fB\fB-c\fR\fIclass_name\fR\fR
  60 .ad
  61 .RS 16n
  62 The driver being added to the system exports the class \fIclass_name\fR. This
  63 option is not normally used directly, but is used by other utilities. It is
  64 only effective when used with the \fB-b\fR option.
  65 .RE
  66
  67 .sp
  68 .ne 2
  69 .na
  70 \fB\fB-i\fR\fIdrivername\fR\fR
  71 .ad
  72 .RS 16n
  73 Only configure the devices for the named driver. The following options are used
  74 by the implementation of \fBadd_drv\fR(8) and \fBrem_drv\fR(8), and may not
  75 be supported in future versions of Solaris:
  76 .RE
  77
  78 .sp
  79 .ne 2
  80 .na
  81 \fB\fB-m\fR\fImajor_num\fR\fR
  82 .ad
  83 .RS 16n
  84 Specify the major number \fImajor_num\fR for this driver to add to the kernel's
  85 \fBname_to_major\fR binding tables.
  86 .RE
  87
  88 .sp
  89 .ne 2
  90 .na
  91 \fB\fB-n\fR\fR
  92 .ad
  93 .RS 16n
  94 Do not try to load and attach any drivers, or if the \fB-i\fR option is given,
  95 do not try to attach the driver named \fIdrivername\fR.
  96 .RE
  97
  98 .sp
  99 .ne 2
 100 .na
 101 \fB\fB-r\fR\fIroot_dir\fR\fR
 102 .ad
 103 .RS 16n
 104 Perform operations under \fIroot_dir\fR, rather than directly under \fBroot\fR.
 105 .RE
 106
 107 .SH EXIT STATUS
 108 .sp
 109 .ne 2
 110 .na
 111 \fB\fB0\fR\fR
 112 .ad
 113 .RS 12n
 114 Successful completion.
 115 .RE
 116
 117 .sp
 118 .ne 2
 119 .na
 120 \fBnon-zero\fR
 121 .ad
 122 .RS 12n
 123 An error occurred.
 124 .RE
 125
 126 .SH FILES
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fB/devices\fR\fR
 131 .ad
 132 .RS 23n
 133 Device nodes directory
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .na
 139 \fB\fB/etc/minor_perm\fR\fR
 140 .ad
 141 .RS 23n
 142 Minor mode permissions
 143 .RE
 144
 145 .sp
 146 .ne 2
 147 .na
 148 \fB\fB/etc/name_to_major\fR\fR
 149 .ad
 150 .RS 23n
 151 Major number binding
 152 .RE
 153
 154 .sp
 155 .ne 2
 156 .na
 157 \fB\fB/etc/driver_classes\fR\fR
 158 .ad
 159 .RS 23n
 160 Driver class binding file
 161 .RE
 162
 163 .SH SEE ALSO
 164 .sp
 165 .LP
 166 \fBsh\fR(1), \fBadd_drv\fR(8), \fBmodinfo\fR(8), \fBmodload\fR(8),
 167 \fBmodunload\fR(8), \fBrem_drv\fR(8), \fBupdate_drv\fR(8),
 168 \fBpath_to_inst\fR(4), \fBattributes\fR(5), \fBdevfs\fR(7FS)