share/man/man8/nfsmapid.8

   1 .\"
   2 .\" The contents of this file are subject to the terms of the
   3 .\" Common Development and Distribution License (the "License").
   4 .\" You may not use this file except in compliance with the License.
   5 .\"
   6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   7 .\" or http://www.opensolaris.org/os/licensing.
   8 .\" See the License for the specific language governing permissions
   9 .\" and limitations under the License.
  10 .\"
  11 .\" When distributing Covered Code, include this CDDL HEADER in each
  12 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  13 .\" If applicable, add the following below this CDDL HEADER, with the
  14 .\" fields enclosed by brackets "[]" replaced with your own identifying
  15 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  16 .\"
  17 .\"
  18 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
  19 .\" Copyright 2016 Nexenta Systems, Inc.
  20 .\"
  21 .Dd March 12, 2016
  22 .Dt NFSMAPID 8
  23 .Os
  24 .Sh NAME
  25 .Nm nfsmapid
  26 .Nd NFS user and group id mapping daemon
  27 .Sh SYNOPSIS
  28 .Nm /usr/lib/nfs/nfsmapid
  29 .Sh DESCRIPTION
  30 The
  31 .Nm
  32 daemon maps to and from NFS version 4
  33 .Sy owner
  34 and
  35 .Sy owner_group
  36 identification attributes and local UID and GID numbers used by both the NFS
  37 version 4 client and server.
  38 .Pp
  39 .Nm
  40 uses the
  41 .Sy passwd
  42 and
  43 .Sy group
  44 entries in the
  45 .Pa /etc/nsswitch.conf
  46 file to direct how it performs the mappings.
  47 .Pp
  48 The
  49 .Nm
  50 daemon has no external, customer-accessible interfaces.
  51 You can, however, administratively configure
  52 .Nm
  53 in one of the following ways:
  54 .Bl -bullet
  55 .It
  56 Set the
  57 .Sy nfsmapid_domain
  58 property for the
  59 .Nm nfs
  60 protocol using
  61 .Xr sharectl 8 .
  62 .It
  63 Specify the
  64 .Sy _nfsv4idmapdomain
  65 DNS resource record.
  66 .El
  67 .Sh SEE ALSO
  68 .Xr svcs 1 ,
  69 .Xr automountd 8 ,
  70 .Xr groupdel 8 ,
  71 .Xr groupmod 8 ,
  72 .Xr mount_nfs 8 ,
  73 .Xr passmgmt 8 ,
  74 .Xr share_nfs 8 ,
  75 .Xr sharectl 8 ,
  76 .Xr svcadm 8 ,
  77 .Xr userdel 8 ,
  78 .Xr usermod 8 ,
  79 .Xr nfs 4 ,
  80 .Xr attributes 5 ,
  81 .Xr smf 5
  82 .Sh NOTES
  83 The
  84 .Nm
  85 service is managed by the service management facility,
  86 .Xr smf 5 ,
  87 under the service identifier:
  88 .Bd -literal -offset indent
  89 svc:/network/nfs/mapid
  90 .Ed
  91 .Pp
  92 Administrative actions on this service, such as enabling, disabling, or
  93 requesting restart, can be performed using
  94 .Xr svcadm 8 .
  95 The service's status can be queried using the
  96 .Xr svcs 1
  97 command.
  98 .Pp
  99 If it is disabled, it will be enabled by
 100 .Xr mount_nfs 8 ,
 101 .Xr share_nfs 8 ,
 102 and
 103 .Xr automountd 8 ,
 104 unless its
 105 .Sy application Ns / Ns Sy auto_enable
 106 property is set to
 107 .Sy false .
 108 .Pp
 109 .Nm
 110 caches a user's UID and GID.
 111 If a user subsequently changes a UID or GID, using one of the utilities listed
 112 below, the
 113 .Nm
 114 cache becomes stale.
 115 At this point, any NFS operation that gets or set attributes will result in the
 116 exchange of this stale information.
 117 To resolve this situation, restart
 118 .Nm ,
 119 as follows:
 120 .Bd -literal -offset indent
 121 # svcadm restart svc:/network/nfs/mapid:default
 122 .Ed
 123 .Pp
 124 The utilities that allow you to change UID and GID are:
 125 .Bl -bullet
 126 .It
 127 .Xr usermod 8
 128 .It
 129 .Xr userdel 8
 130 .It
 131 .Xr groupmod 8
 132 .It
 133 .Xr groupdel 8
 134 .It
 135 .Xr passmgmt 8
 136 .El