Whamcloud - gitweb
LU-17744 ldiskfs: mballoc stats fixes
[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 a range of NIDs for a nodemap
4 .SH SYNOPSIS
5 .br
6 .B lctl nodemap_add_idmap <--name name> <--idtype {uid|gid}>
7 <--idmap clientid:fsid>
8 .br
9 .SH DESCRIPTION
10 .B nodemap_add_idmap adds an identity mapping to a nodemap. Clients that are
11 members of the given nodemap will have the identities of their users mapped
12 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" depending on if it is a user ID or group ID that is to
20 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 .fi
32
33 .SH AVAILABILITY
34 .B lctl
35 is part of the
36 .BR Lustre (7)
37 filesystem package.
38 .SH SEE ALSO
39 .BR lustre (7),
40 .BR lctl-nodemap-activate (8),
41 .BR lctl-nodemap-add (8),
42 .BR lctl-nodemap-del (8),
43 .BR lctl-nodemap-add-range (8),
44 .BR lctl-nodemap-del-range (8),
45 .BR lctl-nodemap-del-idmap (8),
46 .BR lctl-nodemap-modify (8)