summaryrefslogtreecommitdiffstats
path: root/src/man/include/override_homedir.xml
blob: 773d0b6616858ab5c0139033255bc60076857651 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
<varlistentry>
<term>override_homedir (string)</term>
<listitem>
    <para>
        Override the user's home directory. You
        can either provide an absolute value or a
        template. In the template, the following
        sequences are substituted:
        <variablelist>
            <varlistentry>
                <term>%u</term>
                <listitem><para>login name</para></listitem>
            </varlistentry>
            <varlistentry>
                <term>%U</term>
                <listitem><para>UID number</para></listitem>
            </varlistentry>
            <varlistentry>
                <term>%d</term>
                <listitem><para>domain name</para></listitem>
            </varlistentry>
            <varlistentry>
                <term>%f</term>
                <listitem><para>fully qualified user name (user@domain)</para></listitem>
            </varlistentry>
            <varlistentry>
                <term>%o</term>
                <listitem><para>
                    The original home directory retrieved
                    from the identity provider.
                    </para></listitem>
            </varlistentry>
            <varlistentry>
                <term>%%</term>
                <listitem><para>a literal '%'</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </para>
    <para>
        This option can also be set per-domain.
    </para>
    <para>
        example:
        <programlisting>
override_homedir = /home/%u
        </programlisting>
    </para>
    <para>
        Default: Not set (SSSD will use the value
        retrieved from LDAP)
    </para>
</listitem>
</varlistentry>