'\"macro stdmacro
.if n .pH g1a.editsa.1m @(#)editsa	40.8 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} editsa 1M "Essential Utilities" "\&"
.if \nX=1 .ds x} editsa 1M "Essential Utilities"
.if \nX=2 .ds x} editsa 1M "" "\&"
.if \nX=3 .ds x} editsa "" "" "\&"
.TH \*(x}
.SH NAME
\f4editsa\f1 \- add/delete entry from software application file
.SH SYNOPSIS
\f4/usr/sbin/editsa \-i\fP \f2slot\fP \f2HWNAME SWNAME\fP
.sp
\f4/usr/sbin/editsa \-r\fP \f2SWNAME\fP
.sp
\f4/usr/sbin/editsa \-l\fP
.SH DESCRIPTION
The \f4editsa\f1 command is used to add, delete or list entries in the software
application file, \f4/dgn/.edt_swapp\f1. It is primarily used in
application installation scripts to modify the software application
file. This file allows a software driver, \f2SWNAME\f1,
to be associated
with a specific board in a specific AT&T 3B2 Computer expansion slot.
The file \f4/dgn/.edt_swapp\f1 is a data base which
is read by the firmware program \f4filledt\f1 to update the \f2name\f1
field for designated Equipped Device Table (EDT) entries.
\f4editsa\f1 performs various checks to ensure the request will 
result in a valid system configuration.
.PP
The valid uses of \f4editsa\f1 are as shown above and an error
will be returned if not properly entered.
The option and argument definitions are as follows:
.TP 11
\f4\-i\f1
Specifies that the corresponding entry should be 
added to the software application file.
.TP
\f2slot\f1
The slot entry in the EDT for which the board,\f2
HWNAME\f1, is to be replaced by the argument specified as \f2SWNAME\f1.
.TP
\f2HWNAME\f1
The name of the hardware device (e.g. PORTS, ISC, NI) for
which the EDT entry is being renamed.
.TP
\f2SWNAME\f1
The name of the driver which is being dynamically assigned
to a hardware device or removed as a valid entry in the software
application file.
.TP
\f4\-r\f1
All entries which match the \f2SWNAME\f1 specified in the command line
will be removed from the software application file.
.TP
\f4\-l\f1
Prints a formatted display of the software application file.
.SH FILES
\f4/stand/filledt\fP
.br
\f4/dgn/.edt_swapp\fP
.br
\f4/dgn/edt_data\fP
.SH "SEE ALSO"
\f4edittbl\fP(1M),
\f4firmware\fP(8).
.SH DIAGNOSTICS
All errors from \f4editsa\f1 are fatal and return an error code
of 1 with the exception of a warning message for the case when the \f2HWNAME\f1
specified does not match the EDT entry for the slot
requested on the command line. This warning returns an error code of 2.
.Ee
