diff options
author | Pavel Březina <pbrezina@redhat.com> | 2015-07-24 09:58:11 +0200 |
---|---|---|
committer | Jakub Hrozek <jhrozek@redhat.com> | 2015-07-27 22:48:26 +0200 |
commit | b69cb1787209e85cc246eb9a944242689bfe0c46 (patch) | |
tree | ef5137a16c319e6fed252d4d7266dfcff99526b0 /src/man | |
parent | 284937e6b5b0c9d7a1d3382d0d2820d1168842fb (diff) | |
download | sssd-b69cb1787209e85cc246eb9a944242689bfe0c46.tar.gz sssd-b69cb1787209e85cc246eb9a944242689bfe0c46.tar.xz sssd-b69cb1787209e85cc246eb9a944242689bfe0c46.zip |
TOOLS: add sss_override for local overrides
Resolves:
https://fedorahosted.org/sssd/ticket/2584
Reviewed-by: Jakub Hrozek <jhrozek@redhat.com>
Diffstat (limited to 'src/man')
-rw-r--r-- | src/man/Makefile.am | 1 | ||||
-rw-r--r-- | src/man/po/po4a.cfg | 1 | ||||
-rw-r--r-- | src/man/sss_override.8.xml | 108 |
3 files changed, 110 insertions, 0 deletions
diff --git a/src/man/Makefile.am b/src/man/Makefile.am index 1ef1da48c..70cadf595 100644 --- a/src/man/Makefile.am +++ b/src/man/Makefile.am @@ -51,6 +51,7 @@ man_MANS = \ sssd-krb5.5 sssd-simple.5 \ sssd_krb5_locator_plugin.8 sss_groupshow.8 \ pam_sss.8 sss_obfuscate.8 sss_cache.8 sss_debuglevel.8 sss_seed.8 \ + sss_override.8 $(NULL) if BUILD_SAMBA diff --git a/src/man/po/po4a.cfg b/src/man/po/po4a.cfg index 25d20c6f0..67e87ba70 100644 --- a/src/man/po/po4a.cfg +++ b/src/man/po/po4a.cfg @@ -11,6 +11,7 @@ [type:docbook] sssd-sudo.5.xml $lang:$(builddir)/$lang/sssd-sudo.5.xml [type:docbook] sssd.8.xml $lang:$(builddir)/$lang/sssd.8.xml [type:docbook] sss_obfuscate.8.xml $lang:$(builddir)/$lang/sss_obfuscate.8.xml +[type:docbook] sss_override.8.xml $lang:$(builddir)/$lang/sss_override.8.xml [type:docbook] sss_useradd.8.xml $lang:$(builddir)/$lang/sss_useradd.8.xml [type:docbook] sssd-krb5.5.xml $lang:$(builddir)/$lang/sssd-krb5.5.xml [type:docbook] sss_groupadd.8.xml $lang:$(builddir)/$lang/sss_groupadd.8.xml diff --git a/src/man/sss_override.8.xml b/src/man/sss_override.8.xml new file mode 100644 index 000000000..ec9a7bb75 --- /dev/null +++ b/src/man/sss_override.8.xml @@ -0,0 +1,108 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook V4.4//EN" +"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"> +<reference> +<title>SSSD Manual pages</title> +<refentry> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/upstream.xml" /> + + <refmeta> + <refentrytitle>sss_override</refentrytitle> + <manvolnum>8</manvolnum> + </refmeta> + + <refnamediv id='name'> + <refname>sss_override</refname> + <refpurpose>create local overrides of user and group attributes</refpurpose> + </refnamediv> + + <refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command>sss_override</command> + <arg choice='plain'><replaceable>COMMAND</replaceable></arg> + <arg choice='opt'> + <replaceable>options</replaceable> + </arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + <command>sss_override</command> enables to create a client-side + view and allows to change selected values of specific user + and groups. This change takes effect only on local machine. + </para> + <para> + Overrides data are stored in SSSD cache. If the cache is deleted + all local overrides are lost. + </para> + </refsect1> + + <refsect1 id='commands'> + <title>AVAILABLE COMMANDS</title> + <para> + Argument <emphasis>NAME</emphasis> is the name of original object + in all commands. It is not possible to override + <emphasis>uid</emphasis> or <emphasis>gid</emphasis> to 0. + </para> + <variablelist remap='IP'> + <varlistentry> + <term> + <option>user-add</option> + <emphasis>NAME</emphasis> + <optional><option>-n,--name</option> NAME</optional> + <optional><option>-u,--uid</option> UID</optional> + <optional><option>-g,--gid</option> GID</optional> + <optional><option>-h,--home</option> HOME</optional> + <optional><option>-s,--shell</option> SHELL</optional> + <optional><option>-c,--gecos</option> GECOS</optional> + </term> + <listitem> + <para> + Override attributes of an user. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>user-del</option> + <emphasis>NAME</emphasis> + </term> + <listitem> + <para> + Remove user overrides. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>group-add</option> + <emphasis>NAME</emphasis> + <optional><option>-n,--name</option> NAME</optional> + <optional><option>-g,--gid</option> GID</optional> + </term> + <listitem> + <para> + Override attributes of a group. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>group-del</option> + <emphasis>NAME</emphasis> + </term> + <listitem> + <para> + Remove group overrides. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/seealso.xml" /> + +</refentry> +</reference> |