usr/src/man/man1m/dfshares.1m

   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 1M "Nov 6, 2000"
   7 .SH NAME
   8 dfshares \- list available resources from remote or local systems
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBdfshares\fR [\fB-F\fR \fIFSType\fR] [\fB-h\fR] [\fB-o\fR \fIspecific_options\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 a distributed file system of type \fIFSType\fR. \fIspecific_options\fR
  20 as well as the semantics of \fIserver\fR are specific to particular distributed
  21 file systems.
  22 .sp
  23 .LP
  24 If \fBdfshares\fR is entered without arguments, all resources  currently shared
  25 on the local system are displayed, regardless  of file system type.
  26 .sp
  27 .LP
  28 The output of \fBdfshares\fR consists of an optional header line (suppressed
  29 with the \fB-h\fR flag) followed by a list of lines containing
  30 whitespace-separated fields.  For each resource, the fields are:
  31 .sp
  32 .in +2
  33 .nf
  34 \fIresource server access transport\fR
  35 .fi
  36 .in -2
  37
  38 .sp
  39 .LP
  40 where
  41 .sp
  42 .ne 2
  43 .na
  44 \fB\fIresource\fR\fR
  45 .ad
  46 .RS 13n
  47 Specifies the resource name that must be given to the \fBmount\fR(1M) command.
  48 .RE
  49
  50 .sp
  51 .ne 2
  52 .na
  53 \fB\fIserver\fR\fR
  54 .ad
  55 .RS 13n
  56 Specifies the name of the system that is making the resource available.
  57 .RE
  58
  59 .sp
  60 .ne 2
  61 .na
  62 \fB\fIaccess\fR\fR
  63 .ad
  64 .RS 13n
  65 Specifies the access permissions granted to the client systems, either \fBro\fR
  66 (for read-only) or \fBrw\fR (for read/write). If \fBdfshares\fR cannot
  67 determine access permissions, a hyphen  (\fB\(mi\fR) is displayed.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fItransport\fR\fR
  74 .ad
  75 .RS 13n
  76 Specifies the transport provider over which the resource is shared.
  77 .RE
  78
  79 .sp
  80 .LP
  81 A field may be null. Each null field is indicated by a hyphen (\(mi) unless the
  82 remainder of the fields on the line are also null; in which case, the hyphen
  83 may be omitted.
  84 .SH OPTIONS
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fB-F\fR \fIFSType\fR\fR
  89 .ad
  90 .RS 23n
  91 Specify filesystem type.  Defaults to the first entry in
  92 \fB/etc/dfs/fstypes\fR.
  93 .RE
  94
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fB-h\fR\fR
  99 .ad
 100 .RS 23n
 101 Suppress header line in output.
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fB\fB-o\fR \fIspecific_options\fR\fR
 108 .ad
 109 .RS 23n
 110 Specify options specific to the filesystem provided by the \fB-F\fR option.
 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 \fBdfmounts\fR(1M), \fBmount\fR(1M), \fBshare\fR(1M), \fBunshare\fR(1M),
 127 \fBattributes\fR(5)