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 30The 31.Nm 32daemon maps to and from NFS version 4 33.Sy owner 34and 35.Sy owner_group 36identification attributes and local UID and GID numbers used by both the NFS 37version 4 client and server. 38.Pp 39.Nm 40uses the 41.Sy passwd 42and 43.Sy group 44entries in the 45.Pa /etc/nsswitch.conf 46file to direct how it performs the mappings. 47.Pp 48The 49.Nm 50daemon has no external, customer-accessible interfaces. 51You can, however, administratively configure 52.Nm 53in one of the following ways: 54.Bl -bullet 55.It 56Set the 57.Sy nfsmapid_domain 58property for the 59.Nm nfs 60protocol using 61.Xr sharectl 8 . 62.It 63Specify the 64.Sy _nfsv4idmapdomain 65DNS resource record. 66.El 67.Sh SEE ALSO 68.Xr svcs 1 , 69.Xr nfs 5 , 70.Xr attributes 7 , 71.Xr smf 7 , 72.Xr automountd 8 , 73.Xr groupdel 8 , 74.Xr groupmod 8 , 75.Xr mount_nfs 8 , 76.Xr passmgmt 8 , 77.Xr share_nfs 8 , 78.Xr sharectl 8 , 79.Xr svcadm 8 , 80.Xr userdel 8 , 81.Xr usermod 8 82.Sh NOTES 83The 84.Nm 85service is managed by the service management facility, 86.Xr smf 7 , 87under the service identifier: 88.Bd -literal -offset indent 89svc:/network/nfs/mapid 90.Ed 91.Pp 92Administrative actions on this service, such as enabling, disabling, or 93requesting restart, can be performed using 94.Xr svcadm 8 . 95The service's status can be queried using the 96.Xr svcs 1 97command. 98.Pp 99If it is disabled, it will be enabled by 100.Xr mount_nfs 8 , 101.Xr share_nfs 8 , 102and 103.Xr automountd 8 , 104unless its 105.Sy application Ns / Ns Sy auto_enable 106property is set to 107.Sy false . 108.Pp 109.Nm 110caches a user's UID and GID. 111If a user subsequently changes a UID or GID, using one of the utilities listed 112below, the 113.Nm 114cache becomes stale. 115At this point, any NFS operation that gets or set attributes will result in the 116exchange of this stale information. 117To resolve this situation, restart 118.Nm , 119as follows: 120.Bd -literal -offset indent 121# svcadm restart svc:/network/nfs/mapid:default 122.Ed 123.Pp 124The 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 137