.\"
.\" $Id: nsr_directive.5,v 1.1.64.1 2005/07/25 17:17:33 btompkin Exp $ Copyright (c) 2005 EMC Corporation.
.\"

.\"
.\" Copyright (c) 2005 EMC Corporation.
.\"
.\" All rights reserved.  This is an UNPUBLISHED work, and
.\" comprises proprietary and confidential information of EMC.
.\" Unauthorized use, disclosure, and distribution are strictly
.\" prohibited.  Use, duplication, or disclosure of the software
.\" and documentation by the U.S. Government is subject to
.\" restrictions set forth in a license agreement between the
.\" Government and EMC or other written agreement specifying
.\" the Government's rights to use the software and any applicable
.\" FAR provisions, such as FAR 52.227-19.
.\"
.TH "NSR_DIRECTIVE" 5 "Aug 23, 06" "StorEdge EBS 7.3.2"
.SH NAME
nsr_directive \- Sun StorEdge EBS resource type ``NSR directive''
.SH SYNOPSIS
.B  "type: NSR directive"
.SH DESCRIPTION
Each NSR directive is described by a single resource of type
.BR "NSR directive"
(see
.BR nsr_resource (5)). 
To edit the NSR directive resources for a Sun StorEdge EBS server, use
.BR nsradmin (8)
or
.B Sun StorEdge EBS Management Console.
See the corresponding manual page for more information on the use
of these Sun StorEdge EBS administration programs.
.LP
These resources are used by the Sun StorEdge EBS ASM (Application Specific Module) 
family of commands when processing files; see
.BR uasm (8)
and
.BR nsr (5).
Directives can be used to improve the efficiency
of backups by controlling which files get saved and specifying
special handling on certain types of files.
.SH ATTRIBUTES
.LP
The following attributes are defined for resource type
.BR "NSR directive" .
The information in parentheses describes how the attribute values are accessed.
.B Create-only
indicates that the value cannot be changed after
the resource has been created.
.B Read/write
means the value can be updated by authorized administrators.
.B Hidden
means it is an attribute of interest only to programs or experts,
and these attributes can only be seen when the hidden option is turned on in
.BR nsradmin (8).
.B Dynamic
attributes have values which change rapidly.
Several additional attributes such as, administrator, are common
to all resources, and are described in
.BR nsr_resource (5).
.TP
.BR "name"			(create-only)
The names of directive resources are displayed as choices when
creating or updating Sun StorEdge EBS client resources, see
.BR nsr_client (5).
The name can generally be chosen at the administrator's convenience,
but it must be unique for this Sun StorEdge EBS server.
The directive resource named `\fBUnix standard directives\fR' may be modified,
but it may not be deleted. Other directives can only be deleted if no
clients or archive lists are using them.
.br
.I Example:
\fR\s10name: Unix standard directives;\fP\s0
.TP
.BR "comment" "		(read/write)"
This attribute is provided for the administrator to keep any explanatory
remarks or supplementary information about the directive.
.br
.TP
.BR "directive"		(read/write)
This attribute contains the rules defining the directive.
The value of this attribute is similar to the contents of a
.B .nsr
file except that absolute path names must be specified for each
\fB<< \fIpath\fB >>\fR directive.
See
.BR nsr (5)
for more information on the format of Sun StorEdge EBS directives.
.br
.I Example:
\fR\s10directive: "<< / >> skip : core";\fP\s0
.SH Note
Sun StorEdge EBS comes with four directive resources already defined:
"Unix standard directives", "Unix with compression directives",
"DOS standard directives", and "NetWare standard directives".
The first two are meant for use with clients running on UNIX platforms.
"DOS standard directives" is intended for use with clients on machines
running DOS.
The last directive, "NetWare standard directives", is meant for use
with clients running on NetWare platforms.
There may also be two other directives "Default" and
"Default with compression".
These are old names for "Unix standard directives" and
"Unix with compression directives", respectively.
Sun StorEdge EBS will remove the directive resources using the old names when they
are no longer being used.
.SH EXAMPLE
.LP
An example NSR directive resource, named `Unix directive', follows:
.br
.nf
\fR\s10
.ta \w'directive:'u+2nR +1m
	type:	NSR directive;
	name:	Unix directive;
	directive:	"
			 << / >>
			      +skip : core
			      skip : tmp
			 << /usr/spool/mail >>
			      mailasm : *
			 << /nsr >>
			      allow
			";
.ta
\fP\s0
.fi
.SH SEE ALSO
.BR nsr (5),
.BR nsr_resource (5),
.BR savegroup (8),
.BR savefs (8),
.BR uasm (8),
.BR nsradmin (8),