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

   1 '\" te
   2 .\" Copyright (c) 2004, 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 NFSMAPID 1M "Oct 30, 2007"
   7 .SH NAME
   8 nfsmapid \- NFS user and group id mapping daemon
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/nfs/nfsmapid\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBnfsmapid\fR daemon maps to and from NFS version 4 \fBowner\fR and
  19 \fBowner_group\fR identification attributes and local \fBUID\fR and \fBGID\fR
  20 numbers used by both the NFS version 4 client and server.
  21 .sp
  22 .LP
  23 \fBnfsmapid\fR uses the \fBpasswd\fR and \fBgroup\fR entries in the
  24 \fB/etc/nsswitch.conf\fR file to direct how it performs the mappings.
  25 .sp
  26 .LP
  27 The \fBnfsmapid\fR daemon has no external, customer-accessible interfaces. You
  28 can, however, administratively configure \fBnfsmapid\fR in one of the following
  29 ways:
  30 .RS +4
  31 .TP
  32 .ie t \(bu
  33 .el o
  34 Specify the \fBNFSMAPID_DOMAIN\fR parameter in \fBnfs\fR(4)
  35 .RE
  36 .RS +4
  37 .TP
  38 .ie t \(bu
  39 .el o
  40 Specify the \fB_nfsv4idmapdomain\fR DNS resource record.
  41 .RE
  42 .sp
  43 .LP
  44 Please refer to the \fI\fR for further details.
  45 .SH SEE ALSO
  46 .sp
  47 .LP
  48 \fBsvcs\fR(1), \fBautomountd\fR(1M), \fBgroupdel\fR(1M), \fBgroupmod\fR(1M),
  49 \fBmount_nfs\fR(1M), \fBpassmgmt\fR(1M), \fBsvcadm\fR(1M), \fBshare_nfs\fR(1M),
  50 \fBuserdel\fR(1M), \fBusermod\fR(1M), \fBnfs\fR(4), \fBattributes\fR(5),
  51 \fBsmf\fR(5)
  52 .sp
  53 .LP
  54 \fI\fR
  55 .SH NOTES
  56 .sp
  57 .LP
  58 The \fBnfsmapid\fR service is managed by the service management facility,
  59 \fBsmf\fR(5), under the service identifier:
  60 .sp
  61 .in +2
  62 .nf
  63 svc:/network/nfs/mapid
  64 .fi
  65 .in -2
  66 .sp
  67
  68 .sp
  69 .LP
  70 Administrative actions on this service, such as enabling, disabling, or
  71 requesting restart, can be performed using \fBsvcadm\fR(1M). The service's
  72 status can be queried using the \fBsvcs\fR(1) command.
  73 .sp
  74 .LP
  75 If it is disabled, it will be enabled by \fBmount_nfs\fR(1M),
  76 \fBshare_nfs\fR(1M), and \fBautomountd\fR(1M), unless  its
  77 \fBapplication/auto_enable\fR property is set to \fBfalse\fR.
  78 .sp
  79 .LP
  80 \fBnfsmapid\fR caches a user's UID and GID. If a user subsequently changes a
  81 UID or GID, using one of the utilities listed below, the \fBnfsmapid\fR cache
  82 becomes stale. At this point, any NFS operation that gets or set attributes
  83 will result in the exchange of this stale information. To resolve this
  84 situation, restart \fBnfsmapid\fR, as follows:
  85 .sp
  86 .in +2
  87 .nf
  88 # \fBsvcadm restart svc:/network/nfs/mapid:default\fR
  89 .fi
  90 .in -2
  91 .sp
  92
  93 .sp
  94 .LP
  95 The utilities that allow you to change UID and GID are:
  96 .RS +4
  97 .TP
  98 .ie t \(bu
  99 .el o
 100 \fBusermod\fR(1M)
 101 .RE
 102 .RS +4
 103 .TP
 104 .ie t \(bu
 105 .el o
 106 \fBuserdel\fR(1M)
 107 .RE
 108 .RS +4
 109 .TP
 110 .ie t \(bu
 111 .el o
 112 \fBgroupmod\fR(1M)
 113 .RE
 114 .RS +4
 115 .TP
 116 .ie t \(bu
 117 .el o
 118 \fBgroupdel\fR(1M)
 119 .RE
 120 .RS +4
 121 .TP
 122 .ie t \(bu
 123 .el o
 124 \fBpassmgmt\fR(1M)
 125 .RE
 126 .sp
 127 .LP
 128 The \fBnfsmapid\fR daemon might not exist in a future release of Solaris.