share/man/man8/dfshares_nfs.8

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1995, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH DFSHARES_NFS 8 "Nov 6, 2000"
   7 .SH NAME
   8 dfshares_nfs \- list available NFS resources from remote systems
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBdfshares\fR [\fB-F\fR nfs] [\fB-h\fR] [\fIserver\fR]...
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBdfshares\fR provides information about resources available to the host
  19 through \fBNFS.\fR The \fB-F\fR flag may be omitted if  \fBNFS\fR is the first
  20 file system type listed in the file \fB/etc/dfs/fstypes\fR.
  21 .sp
  22 .LP
  23 The query may be restricted to the output of resources available from one or
  24 more servers.
  25 .sp
  26 .LP
  27 \fBdfshares\fR without arguments displays all resources shared on the local
  28 system, regardless of file system type.
  29 .sp
  30 .LP
  31 Specifying  \fIserver\fR displays information about the resources shared by
  32 each server. \fIServer\fR can be any system on the network.  If no server is
  33 specified, then     \fIserver\fR is assumed to be the local system.
  34 .sp
  35 .LP
  36 The output of \fBdfshares\fR consists of an optional header line (suppressed
  37 with the \fB-h\fR flag) followed by a list of lines containing
  38 whitespace-separated fields.  For each resource, the fields are:
  39 .sp
  40 .in +2
  41 .nf
  42 \fIresource server access transport\fR
  43 .fi
  44 .in -2
  45
  46 .sp
  47 .LP
  48 where
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fIresource\fR\fR
  53 .ad
  54 .RS 13n
  55 Specifies the resource name that must be given to the \fBmount\fR(8) command.
  56 .RE
  57
  58 .sp
  59 .ne 2
  60 .na
  61 \fB\fIserver\fR\fR
  62 .ad
  63 .RS 13n
  64 Specifies the system that is making the resource available.
  65 .RE
  66
  67 .sp
  68 .ne 2
  69 .na
  70 \fB\fIaccess\fR\fR
  71 .ad
  72 .RS 13n
  73 Specifies the access permissions granted to the client systems;  however,
  74 \fBdfshares\fR cannot determine this information for an  \fBNFS\fR resource and
  75 populates the field with a hyphen (-).
  76 .RE
  77
  78 .sp
  79 .ne 2
  80 .na
  81 \fB\fItransport\fR\fR
  82 .ad
  83 .RS 13n
  84 Specifies the transport provider over which the \fIresource\fR  is shared;
  85 however, \fBdfshares\fR cannot determine this information for an  \fBNFS\fR
  86 resource and populates the field with a hyphen (-).
  87 .RE
  88
  89 .sp
  90 .LP
  91 A field may be null.  Each null field is indicated by a hyphen (-) unless the
  92 remainder of the fields on the line are also null;  in which case, the hyphen
  93 may be omitted.
  94 .SH OPTIONS
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fB-F\fR \fBnfs\fR\fR
  99 .ad
 100 .RS 10n
 101 Specify the  \fBNFS\fR file system type
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fB\fB-h\fR\fR
 108 .ad
 109 .RS 10n
 110 Suppress header line in output.
 111 .RE
 112
 113 .SH FILES
 114 .sp
 115 .ne 2
 116 .na
 117 \fB\fB/etc/dfs/fstypes\fR\fR
 118 .ad
 119 .RS 20n
 120
 121 .RE
 122
 123 .SH SEE ALSO
 124 .sp
 125 .LP
 126 \fBmount\fR(8), \fBshare\fR(8), \fBunshare\fR(8), \fBattributes\fR(5)