Whamcloud - gitweb
LU-14797 sec: add projid to nodemap
[fs/lustre-release.git] / lustre / doc / lctl-nodemap-add-idmap.8
1 .TH LCTL-NODEMAP_ADD_IDMAP 8 "2015-01-20" Lustre "configuration utilities"
2 .SH NAME
3 lctl-nodemap_add_idmap \- define ID mappings for a nodemap
4 .SH SYNOPSIS
5 .br
6 .B lctl nodemap_add_idmap <--name name> <--idtype {uid|gid|projid}>
7 .B <--idmap clientid:fsid>
8 .br
9 .SH DESCRIPTION
10 .B nodemap_add_idmap
11 adds an identity mapping to a nodemap. Clients that are members of the given
12 nodemap will have the identities of their users mapped accordingly.
13
14 .SH OPTIONS
15 .I name
16 is the name of the nodemap that this idmap should be added to.
17
18 .I idtype
19 is either "uid" or "gid" or "projid" depending on if it is a user ID or group
20 ID or project ID that is to be mapped.
21
22 .I idmap
23 is the identity to map, and what it should be mapped to. The first digit is the
24 ID of the user or group as it is on the client, and the second number is the ID
25 that it should map to on the Lustre filesystem.
26
27 .SH EXAMPLES
28 .nf
29 # lctl nodemap_add_idmap --name remotesite --idtype uid --idmap 2001:1001
30 # lctl nodemap_add_idmap --name remotesite --idtype gid --idmap 2002:1002
31 # lctl nodemap_add_idmap --name remotesite --idtype projid --idmap 33:1
32 .fi
33
34 .SH AVAILABILITY
35 .B lctl
36 is part of the
37 .BR Lustre (7)
38 filesystem package.
39 .SH SEE ALSO
40 .BR lustre (7),
41 .BR lctl-nodemap-activate (8),
42 .BR lctl-nodemap-add (8),
43 .BR lctl-nodemap-del (8),
44 .BR lctl-nodemap-add-range (8),
45 .BR lctl-nodemap-del-range (8),
46 .BR lctl-nodemap-del-idmap (8),
47 .BR lctl-nodemap-modify (8)