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.

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.

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]


Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
Copyright 2016 Nexenta Systems, Inc.

.Dd March 12, 2016 .Dt NFSMAPID 1M .Os .Sh NAME .Nm nfsmapid .Nd NFS user and group id mapping daemon .Sh SYNOPSIS .Nm /usr/lib/nfs/nfsmapid .Sh DESCRIPTION The .Nm daemon maps to and from NFS version 4 .Sy owner and .Sy owner_group identification attributes and local UID and GID numbers used by both the NFS version 4 client and server.

p .Nm uses the .Sy passwd and .Sy group entries in the

a /etc/nsswitch.conf file to direct how it performs the mappings.

p The .Nm daemon has no external, customer-accessible interfaces. You can, however, administratively configure .Nm in one of the following ways: l -bullet t Set the .Sy nfsmapid_domain property for the .Nm nfs protocol using .Xr sharectl 1M . t Specify the .Sy _nfsv4idmapdomain DNS resource record. .El .Sh SEE ALSO .Xr svcs 1 , .Xr automountd 1M , .Xr groupdel 1M , .Xr groupmod 1M , .Xr mount_nfs 1M , .Xr passmgmt 1M , .Xr share_nfs 1M , .Xr sharectl 1M , .Xr svcadm 1M , .Xr userdel 1M , .Xr usermod 1M , .Xr nfs 4 , .Xr attributes 5 , .Xr smf 5 .Sh NOTES The .Nm service is managed by the service management facility, .Xr smf 5 , under the service identifier: d -literal -offset indent svc:/network/nfs/mapid .Ed

p Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using .Xr svcadm 1M . The service's status can be queried using the .Xr svcs 1 command.

p If it is disabled, it will be enabled by .Xr mount_nfs 1M , .Xr share_nfs 1M , and .Xr automountd 1M , unless its .Sy application Ns / Ns Sy auto_enable property is set to .Sy false .

p .Nm caches a user's UID and GID. If a user subsequently changes a UID or GID, using one of the utilities listed below, the .Nm cache becomes stale. At this point, any NFS operation that gets or set attributes will result in the exchange of this stale information. To resolve this situation, restart .Nm , as follows: d -literal -offset indent # svcadm restart svc:/network/nfs/mapid:default .Ed

p The utilities that allow you to change UID and GID are: l -bullet t .Xr usermod 1M t .Xr userdel 1M t .Xr groupmod 1M t .Xr groupdel 1M t .Xr passmgmt 1M .El