Initial import
[mirror/userdir-ldap.git] / doc / ud-generate.8.yo
1 mailto(admin@db.debian.org)
2 manpage(ud-generate)(1)(17 Sep 1999)(userdir-ldap)()
3 manpagename(ud-generate)(Produce machine specific formatted version of the
4 directory)
5
6 manpagesynopsis()
7   ud-generate
8
9 manpagedescription()
10
11 ud-generate prouces machine specific versions of the directory in the
12 following formats:
13
14 itemize(
15   it() passwd file [in normal and DB form]
16   it() shadow file [in normal and DB form]
17   it() group file [in normal and DB form]
18   it() Exim forwarding file
19 )
20
21 Generation of the files is controlled by the configuration file
22 bf(/etc/userdir-ldap/ud-generate.conf). The output is placed in
23 bf(/var/cache/userdir-ldap/hosts/<hostname>/). Each host listed in the
24 configuration file has its own home dir path and its own list of groups that
25 are allowed to login to the machine.
26
27 The format of the configuration file is a one line per host with these fields:
28 verb(host homedirpath group1 group2 ...)
29 Only users who are a member of the named groups are emitted to the output
30 files.
31
32 Authorization to read protected entries from the directory is achieved by
33 reading a username and password from the pass- file in the userdir-ldap
34 directory.
35
36 manpagefiles()
37 itemize(
38   it() /etc/userdir-ldap/userdir-ldap.conf
39   Configuration variables to select what server and what base DN to use.
40   it() /etc/userdir-ldap/ud-generate.conf
41   Configuration variables to determine how hosts are generated.
42   it() /etc/userdir-ldap/pass-<uid>
43   Directory authentication credentials
44 )
45
46 manpageauthor()
47 userdir-ldap was written by Jason Gunthorpe <jgg@debian.org>.
48