Whamcloud - gitweb
LU-12635 build: Support for gcc -Wimplicit-fallthrough
[fs/lustre-release.git] / lustre / doc / lctl-nodemap-add-idmap.8
1 .TH lctl-nodemap-add-idmap 8 "2015 Jan 20" Lustre "configuration utilities"
2 .SH NAME
3 lctl-nodemap-add-idmap \- Define a range of NIDs for a nodemap.
4
5 .SH SYNOPSIS
6 .br
7 .B lctl nodemap_add_idmap <--name name> <--idtype {uid|gid}>
8 <--idmap clientid:fsid>
9 .br
10 .SH DESCRIPTION
11 .B nodemap_add_idmap adds an identity mapping to a nodemap. Clients that are
12 members of the given nodemap will have the identities of their users mapped
13 accordingly.
14
15 .SH OPTIONS
16 .I name
17 is the name of the nodemap that this idmap should be added to.
18
19 .I idtype
20 is either "uid" or "gid" depending on if it is a user ID or group ID that is to
21 be mapped.
22
23 .I idmap
24 is the identity to map, and what it should be mapped to. The first digit is the
25 ID of the user or group as it is on the client, and the second number is the ID
26 that it should map to on the Lustre filesystem.
27
28 .SH EXAMPLES
29 .nf
30 # lctl nodemap_add_idmap --name remotesite --idtype uid --idmap 2001:1001
31 # lctl nodemap_add_idmap --name remotesite --idtype gid --idmap 2002:1002
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)