summaryrefslogtreecommitdiffstats
path: root/src/man/sss_rpcidmapd.5.xml
blob: e2d0fe95bf374b5b0185c84d558af604796fe9f3 (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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<?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>
    <refentryinfo>
        <productname>sss rpc.idmapd plugin</productname>
        <author>
            <firstname>Noam</firstname>
            <surname>Meltzer</surname>
            <affiliation>
                <orgname>Primary Data Inc.</orgname>
            </affiliation>
            <contrib>Developer (2013-2014)</contrib>
        </author>
        <author>
            <firstname>Noam</firstname>
            <surname>Meltzer</surname>
            <contrib>Developer (2014-)</contrib>
            <email>tsnoam@gmail.com</email>
        </author>
    </refentryinfo>

    <refmeta>
        <refentrytitle>sss_rpcidmapd</refentrytitle>
        <manvolnum>5</manvolnum>
        <refmiscinfo class="manual">File Formats and Conventions</refmiscinfo>
    </refmeta>

    <refnamediv id='name'>
        <refname>sss_rpcidmapd</refname>
        <refpurpose>sss plugin configuration directives for rpc.idmapd</refpurpose>
    </refnamediv>

    <refsect1 id='conf-file'>
        <title>CONFIGURATION FILE</title>
        <para>
            rpc.idmapd configuration file is usually found at
            <emphasis>/etc/idmapd.conf</emphasis>. See
            <citerefentry>
                <refentrytitle>idmapd.conf</refentrytitle>
                <manvolnum>5</manvolnum>
            </citerefentry> for more information.
        </para>
    </refsect1>

    <refsect1 id='sss-conf-extension'>
        <title>SSS CONFIGURATION EXTENSION</title>
        <refsect2 id='enable-sss'>
            <title>Enable SSS plugin</title>
            <para>
                In section <quote>[Translation]</quote>, modify/set
                <quote>Method</quote> attribute to contain
                <emphasis>sss</emphasis>.
            </para>
        </refsect2>
        <refsect2 id='sss-conf-sect'>
            <title>[sss] config section</title>
            <para>
                In order to change the default of one of the configuration
                attributes of the <emphasis>sss</emphasis> plugin listed
                below you will need to create a config section for it, named
                <quote>[sss]</quote>.
            </para>
            <variablelist>
                <title>Configuration attributes</title>
                <varlistentry>
                    <term>memcache (bool)</term>
                    <listitem>
                        <para>
                            Indicates whether or not to use memcache
                            optimisation technique.
                        </para>
                        <para>
                            Default: True
                        </para>
                    </listitem>
                </varlistentry>
            </variablelist>
        </refsect2>
    </refsect1>

    <refsect1 id='sssd-integration'>
        <title>SSSD INTEGRATION</title>
        <para>
            The sss plugin requires the <emphasis>NSS Responder</emphasis>
            to be enabled in sssd.
        </para>
        <para>
            The attribute <quote>use_fully_qualified_names</quote> must be
            enabled on all domains (NFSv4 clients expect a fully qualified name
            to be sent on the wire).
        </para>
    </refsect1>

    <refsect1 id='example'>
        <title>EXAMPLE</title>
        <para>
            The following example shows a minimal idmapd.conf which makes use of
            the sss plugin.
            <programlisting>
[General]
Verbosity = 2
# domain must be synced between NFSv4 server and clients
# Solaris/Illumos/AIX use "localdomain" as default!
Domain = default

[Mapping]
Nobody-User = nfsnobody
Nobody-Group = nfsnobody

[Translation]
Method = sss
</programlisting>
        </para>
    </refsect1>

    <refsect1 id='see_also'>
        <title>SEE ALSO</title>
        <para>
            <citerefentry>
                <refentrytitle>sssd</refentrytitle><manvolnum>8</manvolnum>
            </citerefentry>,
            <citerefentry>
                <refentrytitle>idmapd.conf</refentrytitle>
                <manvolnum>5</manvolnum>
            </citerefentry>
        </para>
    </refsect1>
</refentry>
</reference>