Whamcloud - gitweb
LU-930 doc: fix format man page sections for lctl
[fs/lustre-release.git] / lustre / doc / lctl-nodemap-set-sepol.8
1 .TH LCTL-NODEMAP_SET_SEPOL 8 "2019-01-21" Lustre "configuration utilities"
2 .SH NAME
3 lctl-nodemap_set_sepol \- set SELinux policy info on a nodemap
4 .SH SYNOPSIS
5 .br
6 .B lctl nodemap_set_sepol --name
7 .RI < nodemap >
8 .B --sepol
9 .RI < sepol >
10 .br
11 .SH DESCRIPTION
12 .B nodemap_set_sepol
13 adds SELinux policy info as described by
14 .I sepol
15 to the specified
16 .IR nodemap .
17 The
18 .I sepol
19 string describing the SELinux policy has the following syntax:
20
21 <mode>:<name>:<version>:<hash>
22
23 where:
24 .RS 4
25 - <mode> is a digit telling if SELinux is in Permissive mode (0) or Enforcing
26 mode (1)
27
28 - <name> is the name of the SELinux policy
29
30 - <version> is the version of the SELinux policy
31
32 - <hash> is the computed hash of the binary representation of the policy, as
33 exported in /etc/selinux/<name>/policy/policy.<version>
34 .RE
35
36 The reference
37 .I sepol
38 string can be obtained on a client node known to enforce the right SELinux policy,
39 by calling the l_getsepol command line utility.
40
41 Clients belonging to
42 .I nodemap
43 must enforce the SELinux policy described by
44 .IR sepol ,
45 otherwise they are denied access to the Lustre file system.
46
47 .SH OPTIONS
48 .I nodemap
49 is the name of the nodemap that this SELinux policy info should be associated
50 with.
51
52 .I sepol
53 is the string describing the SELinux policy that clients must enforce. It has
54 to conform to the syntax described above.
55
56 .SH EXAMPLES
57 .nf
58 # lctl nodemap_set_sepol --name restricted --sepol '1:mls:31:40afb76d077c441b69af58cccaaa2ca63641ed6e21b0a887dc21a684f508b78f'
59 # lctl nodemap_set_sepol --name admins --sepol ''
60 .fi
61
62 .SH AVAILABILITY
63 .B lctl
64 is part of the
65 .BR Lustre (7)
66 filesystem package.
67 .SH SEE ALSO
68 .BR lustre (7),
69 .BR lctl-nodemap-activate (8),
70 .BR lctl-nodemap-add (8),
71 .BR lctl-nodemap-del (8),
72 .BR lctl-nodemap-del-range (8),
73 .BR lctl-nodemap-add-idmap (8),
74 .BR lctl-nodemap-del-idmap (8),
75 .BR lctl-nodemap-modify (8)