'\"macro stdmacro
.if n .pH g1a.dfshares @(#)dfshares	40.9 of 1/9/90
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} dfshares 1M "DFS" "\&"
.if \nX=1 .ds x} dfshares 1M "DFS"
.if \nX=2 .ds x} dfshares 1M "" "\&"
.if \nX=3 .ds x} dfshares "" "" "\&"
.TH \*(x}
.SH NAME
\f4dfshares\f1 \- list available resources from remote or local systems
.SH SYNOPSIS
\f4dfshares\f1
[\f4\-F \f2fstype\f1]
[\f4\-h\f1]
[\f4\-o \f2specific_options\f1]
[\f2server\f1 ...]
.br
.SH DESCRIPTION
\f4dfshares\f1
provides information about resources available to the host through
a distributed file system of type \f2fstype\f1.
\f2Specific_options\f1 as well as the
semantics of \f2server\f1 are specific to particular distributed
file systems.
.P
If \f4dfshares\f1 is entered without arguments, all resources 
currently shared on the local system are displayed, regardless 
of file system type.
.P
The output of \f4dfshares\f1 consists of an optional header line
(suppressed with the \f4\-h\f1 flag) followed by a list of lines
containing whitespace-separated fields.  For each resource, the
fields are:
.LP
.RS 8
\f2resource server access transport description ...\f1
.RE
where
.RS 5
.IP \f2resource\f1 15
Specifies the resource name that must be given to the \f4mount\f1(1M)
command.
.IP \f2server\f1 15
Specifies the name of the system that is making the resource available.
.IP \f2access\f1 15
Specifies the access permissions granted to the client systems, either
\f4ro\f1 (for read-only) or \f4rw\f1 (for read/write).
If \f3dfshares\f1 cannot determine access permissions, a hyphen 
(\f4\-\f1)
is displayed.
.IP \f2transport\f1 15
Specifies the transport provider over which the \f2resource\f1 is shared.
.IP \f2description\f1 15
Describes the resource.
.RE
.P
A field may be null. Each null field is indicated by a
hyphen (\-) unless the remainder of the fields on the line
are also null.  In this case, it may be omitted.
.SH "FILES"
\f4/etc/dfs/fstypes\f1
.SH "SEE ALSO"
\f4dfmounts\f1(1M), \f4mount\f1(1M), \f4share\f1(1M), \f4unshare\f1(1M).
