4 .\" The contents of this file are subject to the terms of the
   5 .\" Common Development and Distribution License (the "License").
   6 .\" You may not use this file except in compliance with the License.
   7 .\"
   8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9 .\" or http://www.opensolaris.org/os/licensing.
  10 .\" See the License for the specific language governing permissions
  11 .\" and limitations under the License.
  12 .\"
  13 .\" When distributing Covered Code, include this CDDL HEADER in each
  14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15 .\" If applicable, add the following below this CDDL HEADER, with the
  16 .\" fields enclosed by brackets "[]" replaced with your own identifying
  17 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  18 .\"
  19 .\" CDDL HEADER END
  20 .\"
  21 .\"
  22 .\" Copyright (C) 2008, Sun Microsystems, Inc. All Rights Reserved
  23 .\" Copyright 2014 Nexenta Systems, Inc.  All rights reserved.

  24 .\"
  25 .Dd November 10, 2014
  26 .Dt SHARE_NFS 1M
  27 .Os
  28 .Sh NAME
  29 .Nm share_nfs
  30 .Nd make local NFS file systems available for mounting by remote systems
  31 .Sh SYNOPSIS
  32 .Nm share
  33 .Op Fl d Ar description
  34 .Op Fl F Sy nfs
  35 .Op Fl o Ar specific_options
  36 .Ar pathname
  37 .Sh DESCRIPTION
  38 The
  39 .Nm share
  40 utility makes local file systems available for mounting by remote systems. It
  41 starts the
  42 .Xr nfsd 1M
  43 and
  44 .Xr mountd 1M
  45 daemons if they are not already running.

 140 .Pp
 141 This option is supported only for AUTH_SYS.
 142 .It Sy index Ns = Ns Ar file
 143 Load
 144 .Ar file
 145 rather than a listing of the directory containing this file when the
 146 directory is referenced by an NFS URL.
 147 .It Sy log Ns Oo = Ns Ar tag Oc
 148 Enables NFS server logging for the specified file system. The optional
 149 .Ar tag
 150 determines the location of the related log files. The
 151 .Ar tag
 152 is defined in
 153 .Pa /etc/nfs/nfslog.conf .
 154 If no
 155 .Ar tag
 156 is specified, the default values associated with the global tag in
 157 .Pa /etc/nfs/nfslog.conf
 158 are used. Support of NFS server logging is only available for NFS Version 2 and
 159 Version 3 requests.







 160 .It Sy none Ns = Ns Ar access_list
 161 Access is not allowed to any client that matches the access list. The exception
 162 is when the access list is an asterisk (*), in which case
 163 .Sy ro
 164 or
 165 .Sy rw
 166 can override
 167 .Sy none .
 168 .It Sy nosub
 169 Prevents clients from mounting subdirectories of shared directories. For
 170 example, if
 171 .Pa /export
 172 is shared with the
 173 .Sy nosub
 174 option on server
 175 .Qq fooey
 176 then a NFS client cannot do:
 177 .Bd -literal -offset indent
 178 mount -F nfs fooey:/export/home/mnt
 179 .Ed

 502 .Ss Example 2 Remap A User Coming From The Particular NFS Client
 503 The following example remaps the user with uid
 504 .Sy 100
 505 at client
 506 .Sy 10.0.0.1
 507 to user
 508 .Sy joe Ns :
 509 .Bd -literal -offset indent
 510 share -o uidmap=100:joe:@10.0.0.1 /export
 511 .Ed
 512 .Sh SEE ALSO
 513 .Xr mount 1M ,
 514 .Xr mountd 1M ,
 515 .Xr nfsd 1M ,
 516 .Xr nfslogd 1M ,
 517 .Xr share 1M ,
 518 .Xr unshare 1M ,
 519 .Xr getnetbyname 3SOCKET ,
 520 .Xr netgroup 4 ,
 521 .Xr nfslog.conf 4 ,

 522 .Xr attributes 5 ,
 523 .Xr nfssec 5
 524 .Sh NOTES
 525 If the
 526 .Sy sec Ns =
 527 option is presented at least once, all uses of the
 528 .Sy window Ns = ,
 529 .Sy rw ,
 530 .Sy ro ,
 531 .Sy rw Ns = ,
 532 .Sy ro Ns = ,
 533 and
 534 .Sy root Ns =
 535 options must come after the first
 536 .Sy sec Ns =
 537 option. If the
 538 .Sy sec Ns =
 539 option is not presented, then
 540 .Sy sec Ns = Ns Sy sys
 541 is implied.

   4 .\" The contents of this file are subject to the terms of the
   5 .\" Common Development and Distribution License (the "License").
   6 .\" You may not use this file except in compliance with the License.
   7 .\"
   8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9 .\" or http://www.opensolaris.org/os/licensing.
  10 .\" See the License for the specific language governing permissions
  11 .\" and limitations under the License.
  12 .\"
  13 .\" When distributing Covered Code, include this CDDL HEADER in each
  14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15 .\" If applicable, add the following below this CDDL HEADER, with the
  16 .\" fields enclosed by brackets "[]" replaced with your own identifying
  17 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  18 .\"
  19 .\" CDDL HEADER END
  20 .\"
  21 .\"
  22 .\" Copyright (C) 2008, Sun Microsystems, Inc. All Rights Reserved
  23 .\" Copyright 2014 Nexenta Systems, Inc.  All rights reserved.
  24 .\" Copyright 2016 Jason King.
  25 .\"
  26 .Dd December 16, 2016
  27 .Dt SHARE_NFS 1M
  28 .Os
  29 .Sh NAME
  30 .Nm share_nfs
  31 .Nd make local NFS file systems available for mounting by remote systems
  32 .Sh SYNOPSIS
  33 .Nm share
  34 .Op Fl d Ar description
  35 .Op Fl F Sy nfs
  36 .Op Fl o Ar specific_options
  37 .Ar pathname
  38 .Sh DESCRIPTION
  39 The
  40 .Nm share
  41 utility makes local file systems available for mounting by remote systems. It
  42 starts the
  43 .Xr nfsd 1M
  44 and
  45 .Xr mountd 1M
  46 daemons if they are not already running.

 141 .Pp
 142 This option is supported only for AUTH_SYS.
 143 .It Sy index Ns = Ns Ar file
 144 Load
 145 .Ar file
 146 rather than a listing of the directory containing this file when the
 147 directory is referenced by an NFS URL.
 148 .It Sy log Ns Oo = Ns Ar tag Oc
 149 Enables NFS server logging for the specified file system. The optional
 150 .Ar tag
 151 determines the location of the related log files. The
 152 .Ar tag
 153 is defined in
 154 .Pa /etc/nfs/nfslog.conf .
 155 If no
 156 .Ar tag
 157 is specified, the default values associated with the global tag in
 158 .Pa /etc/nfs/nfslog.conf
 159 are used. Support of NFS server logging is only available for NFS Version 2 and
 160 Version 3 requests.
 161 .It Sy noaclfab
 162 By default, the NFS server will fabricate POSIX-draft style ACLs in response
 163 to ACL requests from NFS Version 2 or Version 3 clients accessing shared
 164 file systems that do not support POSIX-draft ACLs (such as ZFS).
 165 Specifying
 166 .Sy noaclfab
 167 disables this behavior.
 168 .It Sy none Ns = Ns Ar access_list
 169 Access is not allowed to any client that matches the access list. The exception
 170 is when the access list is an asterisk (*), in which case
 171 .Sy ro
 172 or
 173 .Sy rw
 174 can override
 175 .Sy none .
 176 .It Sy nosub
 177 Prevents clients from mounting subdirectories of shared directories. For
 178 example, if
 179 .Pa /export
 180 is shared with the
 181 .Sy nosub
 182 option on server
 183 .Qq fooey
 184 then a NFS client cannot do:
 185 .Bd -literal -offset indent
 186 mount -F nfs fooey:/export/home/mnt
 187 .Ed

 510 .Ss Example 2 Remap A User Coming From The Particular NFS Client
 511 The following example remaps the user with uid
 512 .Sy 100
 513 at client
 514 .Sy 10.0.0.1
 515 to user
 516 .Sy joe Ns :
 517 .Bd -literal -offset indent
 518 share -o uidmap=100:joe:@10.0.0.1 /export
 519 .Ed
 520 .Sh SEE ALSO
 521 .Xr mount 1M ,
 522 .Xr mountd 1M ,
 523 .Xr nfsd 1M ,
 524 .Xr nfslogd 1M ,
 525 .Xr share 1M ,
 526 .Xr unshare 1M ,
 527 .Xr getnetbyname 3SOCKET ,
 528 .Xr netgroup 4 ,
 529 .Xr nfslog.conf 4 ,
 530 .Xr acl 5 ,
 531 .Xr attributes 5 ,
 532 .Xr nfssec 5
 533 .Sh NOTES
 534 If the
 535 .Sy sec Ns =
 536 option is presented at least once, all uses of the
 537 .Sy window Ns = ,
 538 .Sy rw ,
 539 .Sy ro ,
 540 .Sy rw Ns = ,
 541 .Sy ro Ns = ,
 542 and
 543 .Sy root Ns =
 544 options must come after the first
 545 .Sy sec Ns =
 546 option. If the
 547 .Sy sec Ns =
 548 option is not presented, then
 549 .Sy sec Ns = Ns Sy sys
 550 is implied.