| Richard Haines | accf6a4 | 2011-12-02 10:58:03 +0000 | [diff] [blame^] | 1 | .TH "local.users" "5" "28-Nov-2011" "Security Enhanced Linux" "SELinux configuration" |
| 2 | |
| 3 | .SH "NAME" |
| 4 | local.users \- The SELinux local users configuration file. |
| 5 | |
| 6 | .SH "DESCRIPTION" |
| 7 | The file contains local user definitions in the form of policy language user statements and is only found on older SELinux systems as it has been deprecated and replaced by the \fBsemange\fR(8) services. |
| 8 | .sp |
| 9 | This file is only read by \fBselinux_mkload_policy\fR(3) when \fBSETLOCALDEFS\fR in the SELinux \fIconfig\fR file (see \fBselinux_config\fR(5)) is set to \fI1\fR. |
| 10 | .sp |
| 11 | .BR selinux_users_path "(3) " |
| 12 | will return the active policy path to the directory where this file is located. The default local users file is: |
| 13 | .RS |
| 14 | .I /etc/selinux/{SELINUXTYPE}/contexts/users/local.users |
| 15 | .RE |
| 16 | .sp |
| 17 | Where \fI{SELINUXTYPE}\fR is the entry from the selinux configuration file \fIconfig\fR (see \fBselinux_config\fR(5)). |
| 18 | |
| 19 | .SH "FILE FORMAT" |
| 20 | The file consists of one or more entries terminated with '\fB;\fR', each on a separate line as follows: |
| 21 | .RS |
| 22 | \fBuser \fIseuser_id \fBroles \fIrole_id\fR [[\fBlevel \fIlevel\fR] [\fBrange \fIrange\fR]]\fB;\fR |
| 23 | .RE |
| 24 | .sp |
| 25 | Where: |
| 26 | .RS |
| 27 | .B user |
| 28 | .RS |
| 29 | The user keyword. |
| 30 | .RE |
| 31 | .I seuser_id |
| 32 | .RS |
| 33 | The SELinux user identifier. |
| 34 | .RE |
| 35 | .B roles |
| 36 | .RS |
| 37 | The roles keyword. |
| 38 | .RE |
| 39 | .I role_id |
| 40 | .RS |
| 41 | One or more previously declared role identifiers. Multiple role identifiers consist of a space separated list enclosed in braces '{}'. |
| 42 | .RE |
| 43 | .B level |
| 44 | .RS |
| 45 | If MLS/MCS is configured, the level keyword. |
| 46 | .RE |
| 47 | .I level |
| 48 | .RS |
| 49 | The users default security level. Note that only the sensitivity component of the level (e.g. s0) is required. |
| 50 | .RE |
| 51 | .B range |
| 52 | .RS |
| 53 | If MLS/MCS is configured, the range keyword. |
| 54 | .RE |
| 55 | .I range |
| 56 | .RS |
| 57 | The current and clearance levels that the user can run. These are separated by a hyphen '\fB-\fR' as shown in the \fBEXAMPLE\fR section. |
| 58 | .RE |
| 59 | .RE |
| 60 | |
| 61 | .SH "EXAMPLE" |
| 62 | # ./users/local.users |
| 63 | .br |
| 64 | user test_u roles staff_r level s0 range s0 - s15:c0.c1023; |
| 65 | |
| 66 | .SH "SEE ALSO" |
| 67 | .BR selinux "(8), " semanage "(8), " selinux_users_path "(3), " selinux_config "(5), " selinux_mkload_policy "(3) " |