RepoMirrors
/
selinux
mirror of https://github.com/SELinuxProject/selinux
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
selinux/libselinux/man/man5/user_contexts.5

83 lines
2.6 KiB
Groff
Raw Normal View History

libselinux: Add man/man5 man pages Add service_seusers(5) - those in the ./logins directory, seusers(5), user_contexts(5) - those in the ./contexts/users directory, virtual_domain_context(5) and virtual_image_context(5) man pages. Signed-off-by: Richard Haines <richard_c_haines@btinternet.com> Signed-off-by: Eric Paris <eparis@redhat.com>
2011-12-02 10:59:35 +00:00
.TH "user_contexts" "5" "28-Nov-2011" "Security Enhanced Linux" "SELinux configuration"
.SH "NAME"
libselinux: man: Fix man pages formatting - Add man page sections '(N)' to external references, and '()' on functions described in the same man page. - Escape minus signs when those are expected to be used on the command line or files. - Mark files and variables in italic; Note headings, function names, constants, program options and man page references in bold. - Do not justify and hyphenate SEE ALSO section, and avoid hyphenation on symbol names by prepending them with \%. - Remove trailing dot from NAME section description. - Split sections with a no-op command '.', to visually distinguish them but to avoid introducing spurious vertical space in the formatted output. - Add explicit .sp commands in the SYNOPSIS section between function prototypes, and fix space placement in function protoypes. - Split header includes with .br (instead of the explicit or implicit .sp) so that they are vertically contiguous. - Add missing {} around SELINUXTYPE and POLICYTYPE variable text in paths. - Remove unneeded formatting commands. - Remove spurious blank lines. Signed-off-by: Guillem Jover <guillem@debian.org> Signed-off-by: Eric Paris <eparis@redhat.com> Acked-by: Dan Walsh <dwalsh@redhat.com>
2012-11-13 20:15:34 +00:00
user_contexts \- The SELinux user contexts configuration files
.
libselinux: Add man/man5 man pages Add service_seusers(5) - those in the ./logins directory, seusers(5), user_contexts(5) - those in the ./contexts/users directory, virtual_domain_context(5) and virtual_image_context(5) man pages. Signed-off-by: Richard Haines <richard_c_haines@btinternet.com> Signed-off-by: Eric Paris <eparis@redhat.com>
2011-12-02 10:59:35 +00:00
.SH "DESCRIPTION"
These optional user context configuration files contain entries that allow SELinux-aware login applications such as
.BR PAM (8)
(running in their own process context), to determine the context that a users login session should run under.
.sp
SELinux-aware login applications generally use one or more of the following libselinux functions that read these files from the active policy path:
.RS
.BR get_default_context (3)
.br
.BR get_ordered_context_list (3)
.br
.BR get_ordered_context_list_with_level (3)
.br
.BR get_default_context_with_level (3)
.br
.BR get_default_context_with_role (3)
.br
.BR get_default_context_with_rolelevel (3)
.br
.BR query_user_context (3)
.br
.BR manual_user_enter_context (3)
.RE
.sp
There can be one file for each SELinux user configured on the system. The file path is formed using the path returned by
libselinux: man: Fix man pages formatting - Add man page sections '(N)' to external references, and '()' on functions described in the same man page. - Escape minus signs when those are expected to be used on the command line or files. - Mark files and variables in italic; Note headings, function names, constants, program options and man page references in bold. - Do not justify and hyphenate SEE ALSO section, and avoid hyphenation on symbol names by prepending them with \%. - Remove trailing dot from NAME section description. - Split sections with a no-op command '.', to visually distinguish them but to avoid introducing spurious vertical space in the formatted output. - Add explicit .sp commands in the SYNOPSIS section between function prototypes, and fix space placement in function protoypes. - Split header includes with .br (instead of the explicit or implicit .sp) so that they are vertically contiguous. - Add missing {} around SELINUXTYPE and POLICYTYPE variable text in paths. - Remove unneeded formatting commands. - Remove spurious blank lines. Signed-off-by: Guillem Jover <guillem@debian.org> Signed-off-by: Eric Paris <eparis@redhat.com> Acked-by: Dan Walsh <dwalsh@redhat.com>
2012-11-13 20:15:34 +00:00
.BR \%selinux_user_contexts_path (3)
libselinux: Add man/man5 man pages Add service_seusers(5) - those in the ./logins directory, seusers(5), user_contexts(5) - those in the ./contexts/users directory, virtual_domain_context(5) and virtual_image_context(5) man pages. Signed-off-by: Richard Haines <richard_c_haines@btinternet.com> Signed-off-by: Eric Paris <eparis@redhat.com>
2011-12-02 10:59:35 +00:00
for the active policy, with the SELinux user name appended, for example:
.RS
.I /etc/selinux/{SELINUXTYPE}/contexts/users/unconfined_u
.br
.I /etc/selinux/{SELINUXTYPE}/contexts/users/xguest_u
.RE
.sp
Where \fI{SELINUXTYPE}\fR is the entry from the selinux configuration file \fIconfig\fR (see \fBselinux_config\fR(5)).
.sp
These files contain context information as described in the
.B FILE FORMAT
section.
libselinux: man: Fix man pages formatting - Add man page sections '(N)' to external references, and '()' on functions described in the same man page. - Escape minus signs when those are expected to be used on the command line or files. - Mark files and variables in italic; Note headings, function names, constants, program options and man page references in bold. - Do not justify and hyphenate SEE ALSO section, and avoid hyphenation on symbol names by prepending them with \%. - Remove trailing dot from NAME section description. - Split sections with a no-op command '.', to visually distinguish them but to avoid introducing spurious vertical space in the formatted output. - Add explicit .sp commands in the SYNOPSIS section between function prototypes, and fix space placement in function protoypes. - Split header includes with .br (instead of the explicit or implicit .sp) so that they are vertically contiguous. - Add missing {} around SELINUXTYPE and POLICYTYPE variable text in paths. - Remove unneeded formatting commands. - Remove spurious blank lines. Signed-off-by: Guillem Jover <guillem@debian.org> Signed-off-by: Eric Paris <eparis@redhat.com> Acked-by: Dan Walsh <dwalsh@redhat.com>
2012-11-13 20:15:34 +00:00
.
libselinux: Add man/man5 man pages Add service_seusers(5) - those in the ./logins directory, seusers(5), user_contexts(5) - those in the ./contexts/users directory, virtual_domain_context(5) and virtual_image_context(5) man pages. Signed-off-by: Richard Haines <richard_c_haines@btinternet.com> Signed-off-by: Eric Paris <eparis@redhat.com>
2011-12-02 10:59:35 +00:00
.SH "FILE FORMAT"
Each line in the user context configuration file consists of the following:
.RS
.I login_process user_login_process
.RE
.sp
Where:
.RS
.I login_process
.RS
This consists of a \fIrole\fB:\fItype\fR[\fB:\fIrange\fR] entry that represents the login process context.
.RE
.I user_login_process
.RS
This consists of a \fIrole\fB:\fItype\fR[\fB:\fIrange\fR] entry that represents the user login process context.
.RE
.RE
libselinux: man: Fix man pages formatting - Add man page sections '(N)' to external references, and '()' on functions described in the same man page. - Escape minus signs when those are expected to be used on the command line or files. - Mark files and variables in italic; Note headings, function names, constants, program options and man page references in bold. - Do not justify and hyphenate SEE ALSO section, and avoid hyphenation on symbol names by prepending them with \%. - Remove trailing dot from NAME section description. - Split sections with a no-op command '.', to visually distinguish them but to avoid introducing spurious vertical space in the formatted output. - Add explicit .sp commands in the SYNOPSIS section between function prototypes, and fix space placement in function protoypes. - Split header includes with .br (instead of the explicit or implicit .sp) so that they are vertically contiguous. - Add missing {} around SELINUXTYPE and POLICYTYPE variable text in paths. - Remove unneeded formatting commands. - Remove spurious blank lines. Signed-off-by: Guillem Jover <guillem@debian.org> Signed-off-by: Eric Paris <eparis@redhat.com> Acked-by: Dan Walsh <dwalsh@redhat.com>
2012-11-13 20:15:34 +00:00
.
libselinux: Add man/man5 man pages Add service_seusers(5) - those in the ./logins directory, seusers(5), user_contexts(5) - those in the ./contexts/users directory, virtual_domain_context(5) and virtual_image_context(5) man pages. Signed-off-by: Richard Haines <richard_c_haines@btinternet.com> Signed-off-by: Eric Paris <eparis@redhat.com>
2011-12-02 10:59:35 +00:00
.SH "EXAMPLE"
# Example for xguest_u at /etc/selinux/targeted/contexts/users/xguest_u
.br
system_r:crond_t:s0 xguest_r:xguest_t:s0
.br
system_r:initrc_t:s0 xguest_r:xguest_t:s0
.br
system_r:local_login_t:s0 xguest_r:xguest_t:s0
.br
system_r:remote_login_t:s0 xguest_r:xguest_t:s0
.br
system_r:sshd_t:s0 xguest_r:xguest_t:s0
.br
system_r:xdm_t:s0 xguest_r:xguest_t:s0
.br
xguest_r:xguest_t:s0 xguest_r:xguest_t:s0
libselinux: man: Fix man pages formatting - Add man page sections '(N)' to external references, and '()' on functions described in the same man page. - Escape minus signs when those are expected to be used on the command line or files. - Mark files and variables in italic; Note headings, function names, constants, program options and man page references in bold. - Do not justify and hyphenate SEE ALSO section, and avoid hyphenation on symbol names by prepending them with \%. - Remove trailing dot from NAME section description. - Split sections with a no-op command '.', to visually distinguish them but to avoid introducing spurious vertical space in the formatted output. - Add explicit .sp commands in the SYNOPSIS section between function prototypes, and fix space placement in function protoypes. - Split header includes with .br (instead of the explicit or implicit .sp) so that they are vertically contiguous. - Add missing {} around SELINUXTYPE and POLICYTYPE variable text in paths. - Remove unneeded formatting commands. - Remove spurious blank lines. Signed-off-by: Guillem Jover <guillem@debian.org> Signed-off-by: Eric Paris <eparis@redhat.com> Acked-by: Dan Walsh <dwalsh@redhat.com>
2012-11-13 20:15:34 +00:00
.
libselinux: Add man/man5 man pages Add service_seusers(5) - those in the ./logins directory, seusers(5), user_contexts(5) - those in the ./contexts/users directory, virtual_domain_context(5) and virtual_image_context(5) man pages. Signed-off-by: Richard Haines <richard_c_haines@btinternet.com> Signed-off-by: Eric Paris <eparis@redhat.com>
2011-12-02 10:59:35 +00:00
.SH "SEE ALSO"
libselinux: man: Fix man pages formatting - Add man page sections '(N)' to external references, and '()' on functions described in the same man page. - Escape minus signs when those are expected to be used on the command line or files. - Mark files and variables in italic; Note headings, function names, constants, program options and man page references in bold. - Do not justify and hyphenate SEE ALSO section, and avoid hyphenation on symbol names by prepending them with \%. - Remove trailing dot from NAME section description. - Split sections with a no-op command '.', to visually distinguish them but to avoid introducing spurious vertical space in the formatted output. - Add explicit .sp commands in the SYNOPSIS section between function prototypes, and fix space placement in function protoypes. - Split header includes with .br (instead of the explicit or implicit .sp) so that they are vertically contiguous. - Add missing {} around SELINUXTYPE and POLICYTYPE variable text in paths. - Remove unneeded formatting commands. - Remove spurious blank lines. Signed-off-by: Guillem Jover <guillem@debian.org> Signed-off-by: Eric Paris <eparis@redhat.com> Acked-by: Dan Walsh <dwalsh@redhat.com>
2012-11-13 20:15:34 +00:00
.ad l
.nh
libselinux: Add man/man5 man pages Add service_seusers(5) - those in the ./logins directory, seusers(5), user_contexts(5) - those in the ./contexts/users directory, virtual_domain_context(5) and virtual_image_context(5) man pages. Signed-off-by: Richard Haines <richard_c_haines@btinternet.com> Signed-off-by: Eric Paris <eparis@redhat.com>
2011-12-02 10:59:35 +00:00
.BR selinux "(8), " selinux_user_contexts_path "(3), " PAM "(8), " get_ordered_context_list "(3), " get_ordered_context_list_with_level "(3), " get_default_context_with_level "(3), " get_default_context_with_role "(3), " get_default_context_with_rolelevel "(3), " query_user_context "(3), " manual_user_enter_context "(3), " selinux_config "(5) "