sss_usermod.8.xml revision d10fb882aa4a30f78493b7162f482bb0f17d3ff5
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter<?xml version="1.0" encoding="UTF-8"?>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter<reference>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter<title>SSSD Manual pages</title>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter<refentry>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/upstream.xml" />
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <refmeta>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <refentrytitle>sss_usermod</refentrytitle>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <manvolnum>8</manvolnum>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </refmeta>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <refnamediv id='name'>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <refname>sss_usermod</refname>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <refpurpose>modify a user account</refpurpose>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </refnamediv>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <refsynopsisdiv id='synopsis'>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <cmdsynopsis>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <command>sss_usermod</command>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <arg choice='opt'>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <replaceable>options</replaceable>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </arg>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <arg choice='plain'><replaceable>LOGIN</replaceable></arg>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </cmdsynopsis>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </refsynopsisdiv>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <refsect1 id='description'>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <title>DESCRIPTION</title>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <para>
fcd8093c58638dc7c4f9cddfc97f273b94ce2eadStef Walter <command>sss_usermod</command> modifies the
fcd8093c58638dc7c4f9cddfc97f273b94ce2eadStef Walter account specified by <replaceable>LOGIN</replaceable>
fcd8093c58638dc7c4f9cddfc97f273b94ce2eadStef Walter to reflect the changes that are specified on the command line.
fcd8093c58638dc7c4f9cddfc97f273b94ce2eadStef Walter </para>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter </refsect1>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter <refsect1 id='options'>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter <title>OPTIONS</title>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter <variablelist remap='IP'>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter <varlistentry>
fcd8093c58638dc7c4f9cddfc97f273b94ce2eadStef Walter <term>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <option>-c</option>,<option>--gecos</option>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <replaceable>COMMENT</replaceable>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </term>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <listitem>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <para>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter Any text string describing the user. Often used as
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter the field for the user's full name.
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </para>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </listitem>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </varlistentry>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <varlistentry>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter <term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <option>-h</option>,<option>--home</option>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter <replaceable>HOME_DIR</replaceable>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter </term>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter <listitem>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter <para>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter The home directory of the user account.
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter </para>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter </listitem>
dff909d473f43a6bd0f0286fa2d279c0ebe945c6Stef Walter </varlistentry>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <varlistentry>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <option>-s</option>,<option>--shell</option>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <replaceable>SHELL</replaceable>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <listitem>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <para>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter The user's login shell.
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </para>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </listitem>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </varlistentry>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <varlistentry>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <option>-a</option>,<option>--append-group</option>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <replaceable>GROUPS</replaceable>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <listitem>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <para>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter Append this user to groups specified by the
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <replaceable>GROUPS</replaceable> parameter.
1203e462650f035b0df2304075d60b9a99e36715Stef Walter The <replaceable>GROUPS</replaceable> parameter
1203e462650f035b0df2304075d60b9a99e36715Stef Walter is a comma separated list of group names.
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </para>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </listitem>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </varlistentry>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <varlistentry>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <option>-r</option>,<option>--remove-group</option>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <replaceable>GROUPS</replaceable>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <listitem>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <para>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter Remove this user from groups specified by the
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <replaceable>GROUPS</replaceable> parameter.
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </para>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </listitem>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </varlistentry>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <varlistentry>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <option>-l</option>,<option>--lock</option>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </term>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <listitem>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter <para>
1203e462650f035b0df2304075d60b9a99e36715Stef Walter Lock the user account. The user won't be able
1203e462650f035b0df2304075d60b9a99e36715Stef Walter to log in.
1203e462650f035b0df2304075d60b9a99e36715Stef Walter </para>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </listitem>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </varlistentry>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <varlistentry>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <term>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <option>-u</option>,<option>--unlock</option>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </term>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <listitem>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <para>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek Unlock the user account.
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </para>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </listitem>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </varlistentry>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <varlistentry>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <term>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <option>-Z</option>,<option>--selinux-user</option>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <replaceable>SELINUX_USER</replaceable>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </term>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <listitem>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <para>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek The SELinux user for the user's login.
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </para>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </listitem>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek </varlistentry>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <varlistentry>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <term>
90e04eae7e54ec892a6f239783df94dab5d1ed9aJakub Hrozek <option>--addattr</option>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <replaceable>ATTR_NAME_VAL</replaceable>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter </term>
b699c4d7f85a5404be1d1ee9450331aea869b886Stef Walter <listitem>
<para>
Add an attribute/value pair. The format is
attrname=value.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>--setattr</option>
<replaceable>ATTR_NAME_VAL</replaceable>
</term>
<listitem>
<para>
Set an attribute to a name/value pair. The format
is attrname=value. For multi-valued attributes,
the command replaces the values already present
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>--delattr</option>
<replaceable>ATTR_NAME_VAL</replaceable>
</term>
<listitem>
<para>
Delete an attribute/value pair. The format is attrname=value.
</para>
</listitem>
</varlistentry>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/param_help.xml" />
</variablelist>
</refsect1>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/local.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/seealso.xml" />
</refentry>
</reference>