'\" te
.\"  Copyright 1997 AT&T  Copyright (c) 1997 Sun Microsystems, Inc.  All Rights Reserved.
.\" 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.
.\" 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.
.\" 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]
.TH PUTDEV 1M "Apr 3, 1997"
.SH NAME
putdev \- edits device table
.SH SYNOPSIS
.LP
.nf
\fBputdev\fR \fB-a\fR \fIalias\fR [\fIattribute\fR=\fIvalue\fR [...]]
.fi

.LP
.nf
\fBputdev\fR \fB-m\fR \fIdevice\fR \fIattribute\fR=\fIvalue\fR [\fIattribute\fR = \fIvalue\fR [...]]
.fi

.LP
.nf
\fBputdev\fR \fB-d\fR \fIdevice\fR [\fIattribute\fR [...]]
.fi

.SH DESCRIPTION
.sp
.LP
\fBputdev\fR adds a new device to the device table, modifies an existing device
description or removes a device entry from the table. The first synopsis is
used to add a device. The second synopsis is used to modify existing entries by
adding or changing attributes. If a specified attribute is not defined, this
option adds that attribute to the device definition. If a specified attribute
is already defined, it modifies the attribute definition. The third synopsis is
used to delete either an entire device entry or, if the attribute argument is
used, to delete an attribute assignment for a device.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-a\fR\fR
.ad
.RS 6n
Add a device to the device table using the specified attributes. The device
must be referenced by its \fBalias\fR.
.RE

.sp
.ne 2
.na
\fB\fB-d\fR\fR
.ad
.RS 6n
Remove a device from the device table, when executed without the
\fIattributes\fR argument. Used with the \fIattribute\fR argument, it deletes
the given attribute specification for \fIdevice\fR from the table.
.RE

.sp
.ne 2
.na
\fB\fB-m\fR\fR
.ad
.RS 6n
Modify a device entry in the device table. If an entry already exists, it adds
any specified attributes that are not defined. It also modifies any attributes
which already have a value  with the value specified by this command.
.RE

.SH OPERANDS
.sp
.LP
The following operands are supported:
.sp
.ne 2
.na
\fB\fIalias\fR\fR
.ad
.RS 13n
Designates the alias of the device to be added.
.RE

.sp
.ne 2
.na
\fB\fIattribute\fR\fR
.ad
.RS 13n
Designates a device attribute to be added, modified, or deleted. Can be any of
the device attributes described under \fBDEVICE\fR \fBATTRIBUTES\fR except
\fBalias\fR. This prevents an accidental modification or deletion of a device's
alias from the table.
.RE

.sp
.ne 2
.na
\fB\fIdevice\fR\fR
.ad
.RS 13n
Designates the pathname or alias of the device  whose attribute is to be added,
modified, or removed.
.RE

.sp
.ne 2
.na
\fB\fIvalue\fR\fR
.ad
.RS 13n
Designates the value to be assigned to a device's attribute.
.RE

.SH DEVICE ATTRIBUTES
.sp
.LP
The following list shows the standard device attributes, used by applications
such as \fBufsdump\fR(1M) and \fBufsrestore\fR(1M), which can be defined for a
device. You are not limited to this list, you can define any attribute you
like.
.sp
.ne 2
.na
\fB\fBalias\fR\fR
.ad
.RS 13n
The unique name by which a device is known. No two devices in the database may
share the same alias name. The name is limited in length to 14 characters and
should contain only alphanumeric characters and the following special
characters if they are escaped with a backslash:  underscore ( _ ), dollar sign
($), hyphen (\(mi), and period (.).
.RE

.sp
.ne 2
.na
\fB\fBbdevice\fR\fR
.ad
.RS 13n
The pathname to the block special device node associated with the device, if
any. The associated major/minor combination should be unique within the
database and should match that associated with the \fBcdevice\fR field, if any.
(It is the administrator's responsibility to ensure that these
\fBmajor/minor\fR numbers are unique in the database.)
.RE

.sp
.ne 2
.na
\fB\fBcapacity\fR\fR
.ad
.RS 13n
The capacity of the device or of the typical volume, if removable.
.RE

.sp
.ne 2
.na
\fB\fBcdevice\fR\fR
.ad
.RS 13n
The pathname to the character special device node associated with the device,
if any. The associated major/minor combination should be unique within the
database and should match that associated with the \fBbdevice\fR field, if any.
(It is the administrator's responsibility to ensure that these
\fBmajor/minor\fR numbers are unique in the database.)
.RE

.sp
.ne 2
.na
\fB\fBcyl\fR\fR
.ad
.RS 13n
Used by the command specified in the \fBmkfscmd\fR attribute.
.RE

.sp
.ne 2
.na
\fB\fBdesc\fR\fR
.ad
.RS 13n
A description of any instance of a volume associated with this device (such as
floppy diskette).
.RE

.sp
.ne 2
.na
\fB\fBdpartlist\fR\fR
.ad
.RS 13n
The list of disk partitions associated with this device. Used only if
\fBtype=disk\fR. The list should contain device aliases, each of which must
have \fBtype=dpart\fR.
.RE

.sp
.ne 2
.na
\fB\fBdparttype\fR\fR
.ad
.RS 13n
The type of disk partition represented by this device. Used only if
\fBtype=dpart\fR. It should be either \fBfs\fR (for file system) or \fBdp\fR
(for data partition).
.RE

.sp
.ne 2
.na
\fB\fBerasecmd\fR\fR
.ad
.RS 13n
The command string that, when executed, erases the device.
.RE

.sp
.ne 2
.na
\fB\fBfmtcmd\fR\fR
.ad
.RS 13n
The command string that, when executed, formats the device.
.RE

.sp
.ne 2
.na
\fB\fBfsname\fR\fR
.ad
.RS 13n
The file system name on the file system administered on this partition, as
supplied to the \fB/usr/sbin/labelit\fR command. This attribute is specified
only if \fBtype=dpart\fR and \fBdparttype=fs\fR.
.RE

.sp
.ne 2
.na
\fB\fBgap\fR\fR
.ad
.RS 13n
Used by the command specified in the \fBmkfscmd\fR attribute.
.RE

.sp
.ne 2
.na
\fB\fBmkfscmd\fR\fR
.ad
.RS 13n
The command string that, when executed, places a file system on a previously
formatted device.
.RE

.sp
.ne 2
.na
\fB\fBmountpt\fR\fR
.ad
.RS 13n
The default mount point to use for the device. Used only if the device is
mountable. For disk partitions where \fBtype=dpart\fR and \fBdparttype=fs\fR,
this attribute should specify the location where the partition is normally
mounted.
.RE

.sp
.ne 2
.na
\fB\fBnblocks\fR\fR
.ad
.RS 13n
The number of blocks in the file system administered on this partition. Used
only if \fBtype=dpart\fR and \fBdparttype=fs\fR.
.RE

.sp
.ne 2
.na
\fB\fBninodes\fR\fR
.ad
.RS 13n
The number of inodes in the file system administered on this partition. Used
only if \fBtype=dpart\fR and \fBdparttype=fs\fR.
.RE

.sp
.ne 2
.na
\fB\fBnorewind\fR\fR
.ad
.RS 13n
The name of the character special device node that allows access to the serial
device without rewinding when the device is closed.
.RE

.sp
.ne 2
.na
\fB\fBpathname\fR\fR
.ad
.RS 13n
Defines the pathname to an i-node describing the device (used for non-block or
character device pathnames, such as directories).
.RE

.sp
.ne 2
.na
\fB\fBtype\fR\fR
.ad
.RS 13n
A token that represents inherent qualities of the device. Standard types
include: 9-track, ctape, disk, directory, diskette, dpart, and qtape.
.RE

.sp
.ne 2
.na
\fB\fBvolname\fR\fR
.ad
.RS 13n
The volume name on the file system administered on this partition, as supplied
to the \fB/usr/sbin/labelit\fR command. Used only if \fBtype=dpart\fR and
\fBdparttype=fs\fR.
.RE

.sp
.ne 2
.na
\fB\fBvolume\fR\fR
.ad
.RS 13n
A text string used to describe any instance of a volume associated with this
device. This attribute should not be defined for devices which are not
removable.
.RE

.SH EXIT STATUS
.sp
.LP
The following exit values are returned:
.sp
.ne 2
.na
\fB\fB0\fR\fR
.ad
.RS 5n
Successful completion.
.RE

.sp
.ne 2
.na
\fB\fB1\fR\fR
.ad
.RS 5n
Command syntax was incorrect, an invalid option was used, or an internal error
occurred.
.RE

.sp
.ne 2
.na
\fB\fB2\fR\fR
.ad
.RS 5n
The device table could not be opened for reading, or a new device table could
not be created.
.RE

.sp
.ne 2
.na
\fB\fB3\fR\fR
.ad
.RS 5n
If executed with the \fB-a\fR option, indicates that an entry in the device
table with the alias \fBalias\fR already exits. If executed with the \fB-m\fR
or \fB-d\fR options, indicates that no entry exists for device \fIdevice\fR.
.RE

.sp
.ne 2
.na
\fB\fB4\fR\fR
.ad
.RS 5n
Indicates that  \fB-d\fR was requested and one or more of the specified
attributes were not defined for the device.
.RE

.SH FILES
.sp
.ne 2
.na
\fB\fB/etc/device.tab\fR\fR
.ad
.RS 19n

.RE

.SH SEE ALSO
.sp
.LP
\fBdevattr\fR(1M), \fBputdgrp\fR(1M), \fBufsdump\fR(1M), \fBufsrestore\fR(1M),
\fBattributes\fR(5)
.sp
.LP
\fI\fR