share/man/man8/dfmounts.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 DFMOUNTS 8 "May 24, 2005"
   7 .SH NAME
   8 dfmounts \- display mounted resource information
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBdfmounts\fR [\fB-F\fR \fIFSType\fR] [\fB-h\fR] [\fB-o\fR \fIspecific_options\fR]
  13      [\fIrestriction\fR]...
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fBdfmounts\fR shows the local resources shared through a distributed file
  20 system \fIFSType\fR along with a list of clients that have the resource
  21 mounted. If \fIrestriction\fR is not specified, \fBdfmounts\fR shows file
  22 systems that are currently shared on any \fBNFS\fR server.
  23 \fIspecific_options\fR as well as the availability and semantics of
  24 \fIrestriction\fR are specific to particular distributed file system types.
  25 .sp
  26 .LP
  27 If \fBdfmounts\fR is entered without arguments, remote resources currently
  28 mounted on the local system are displayed, regardless of file system type.
  29 However, the \fBdfmounts\fR command does not display the names of NFS Version 4
  30 clients.
  31 .SS "\fBdfmounts\fR Output"
  32 .sp
  33 .LP
  34 The output of \fBdfmounts\fR consists of an optional header line (suppressed
  35 with the \fB-h\fR flag) followed by a list of lines containing
  36 whitespace-separated fields. For each resource, the fields are:
  37 .sp
  38 .in +2
  39 .nf
  40 \fIresource server pathname clients ...\fR
  41 .fi
  42 .in -2
  43
  44 .sp
  45 .LP
  46 where:
  47 .sp
  48 .ne 2
  49 .na
  50 \fB\fIresource\fR\fR
  51 .ad
  52 .RS 12n
  53 Specifies the resource name that must be given to the \fBmount\fR(8) command.
  54 .RE
  55
  56 .sp
  57 .ne 2
  58 .na
  59 \fB\fIserver\fR\fR
  60 .ad
  61 .RS 12n
  62 Specifies the system from which the resource was mounted.
  63 .RE
  64
  65 .sp
  66 .ne 2
  67 .na
  68 \fB\fIpathname\fR\fR
  69 .ad
  70 .RS 12n
  71 Specifies the pathname that must be given to the \fBshare\fR(8) command.
  72 .RE
  73
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fIclients\fR\fR
  78 .ad
  79 .RS 12n
  80 Is a comma-separated list of systems that have mounted the resource. Clients
  81 are listed in the form \fIdomain.\fR, \fIdomain.system\fR, or \fIsystem\fR,
  82 depending on the file system type.
  83 .RE
  84
  85 .sp
  86 .LP
  87 A field can be null. Each null field is indicated by a hyphen (\(mi) unless the
  88 remainder of the fields on the line are also null, in which case the hyphen can
  89 be omitted.
  90 .sp
  91 .LP
  92 Fields with whitespace are enclosed in quotation marks (\fB"\|"\fR).
  93 .SH OPTIONS
  94 .sp
  95 .ne 2
  96 .na
  97 \fB\fB-F\fR \fIFSType\fR\fR
  98 .ad
  99 .RS 23n
 100 Specify filesystem type. Defaults to the first entry in \fB/etc/dfs/fstypes\fR.
 101 \fBNote\fR: currently the only valid \fIFSType\fR is \fBnfs\fR.
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fB\fB-h\fR\fR
 108 .ad
 109 .RS 23n
 110 Suppress header line in output.
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fB\fB-o\fR \fIspecific_options\fR\fR
 117 .ad
 118 .RS 23n
 119 Specify options specific to the filesystem provided by the \fB-F\fR option.
 120 \fBNote\fR: currently no options are supported.
 121 .RE
 122
 123 .SH FILES
 124 .sp
 125 .ne 2
 126 .na
 127 \fB\fB/etc/dfs/fstypes\fR\fR
 128 .ad
 129 .RS 20n
 130 file system types
 131 .RE
 132
 133 .SH SEE ALSO
 134 .sp
 135 .LP
 136 \fBdfshares\fR(8), \fBmount\fR(8), \fBshare\fR(8), \fBunshare\fR(8),
 137 \fBattributes\fR(5)