1 --- ./FAQ.org 2004-07-22 09:37:00.000000000 +0200
2 +++ ./FAQ 2008-01-18 10:03:04.000000000 +0100
7 -* Virtual users: /etc/pureftpd.pdb .
8 +* Virtual users: /etc/ftp/pureftpd.pdb .
10 --> I made changes to /etc/pureftpd.passwd but the server doesn't understand
11 +-> I made changes to /etc/ftp/pureftpd.passwd but the server doesn't understand
12 them: I can't access any account I just created.
14 -The server never reads /etc/pureftpd.passwd directly. Instead, it reads
15 -/etc/pureftpd.pdb (or whatever file name you gave after -lpuredb:...) .
16 +The server never reads /etc/ftp/pureftpd.passwd directly. Instead, it reads
17 +/etc/ftp/pureftpd.pdb (or whatever file name you gave after -lpuredb:...) .
19 -This file is a copy of /etc/pureftpd.passwd, but in a binary format,
20 +This file is a copy of /etc/ftp/pureftpd.passwd, but in a binary format,
21 optimized for fast lookups.
23 -After having made a manual change to /etc/pureftpd.passwd, you must rebuild
24 -/etc/pureftpd.pdb with the following commands:
25 +After having made a manual change to /etc/ftp/pureftpd.passwd, you must rebuild
26 +/etc/ftp/pureftpd.pdb with the following commands:
30 If you add/delete/modify user accounts with pure-pw useradd/usermod/userdel/
31 passwd, don't forget the '-m' option to automatically rebuild
32 -/etc/pureftpd.pdb and not only update /etc/pureftpd.passwd .
33 +/etc/ftp/pureftpd.pdb and not only update /etc/ftp/pureftpd.passwd .
39 Let's start the FTP server:
41 -/usr/local/sbin/pure-ftpd -lpuredb:/etc/pureftpd.pdb -H -B
42 +/usr/local/sbin/pure-ftpd -lpuredb:/etc/ftp/pureftpd.pdb -H -B
44 Everything should be ok now.
46 --- ./README.Virtual-Users.org 2004-02-29 22:49:37.000000000 +0100
47 +++ ./README.Virtual-Users 2008-01-18 10:05:10.000000000 +0100
49 servers. Use per-ip limits instead.
51 Ok, "joe" has been created. By default, the list of virtual users is stored
52 -in the /etc/pureftpd.passwd file (you can of course change this with -f
53 +in the /etc/ftp/pureftpd.passwd file (you can of course change this with -f
56 Let's have a look at its content:
59 pure-pw usermod joe -n 1000 -N 10
61 -Let's have a look at /etc/pureftpd.passwd:
62 +Let's have a look at /etc/ftp/pureftpd.passwd:
64 joe:$1$LX/3.F60$bYdYwsQOYIaWq.Ko.hfI3.:500:101::/home/ftpusers/joe/./::::::1000:10485760::::::
67 ------------------------ DISPLAYING INFO ------------------------
70 -To review info about one user, reading the /etc/pureftpd.passwd file is ok,
71 +To review info about one user, reading the /etc/ftp/pureftpd.passwd file is ok,
72 but it's not really human-friendly.
74 It's why you can use "pure-pw show", whoose syntax is:
78 You can add, modify and delete users with the previous commands, or by
79 -editing /etc/pureftpd.passwd by hand. But the FTP server won't consider the
80 +editing /etc/ftp/pureftpd.passwd by hand. But the FTP server won't consider the
81 changes you make to that file, until you commit them.
83 Commiting changes really means that a new file is created from
84 -/etc/pureftpd.passwd (or whatever file name you choose) . That new file is a
85 +/etc/ftp/pureftpd.passwd (or whatever file name you choose) . That new file is a
86 PureDB file. It contains exactly the same info than the other file. But in
87 that file, accounts are sorted and indexed for faster access, even with
88 thousands of accounts. PureDB files are binary files, don't try to view them
89 or your terminal will beep like hell.
91 -Let's create a PureDB file from /etc/pureftpd.passwd. The indexed file will
92 -be called /etc/pureftpd.pdb (as always, choose whatever name you like):
93 +Let's create a PureDB file from /etc/ftp/pureftpd.passwd. The indexed file will
94 +be called /etc/ftp/pureftpd.pdb (as always, choose whatever name you like):
98 -this reads /etc/pureftpd.passwd and creates /etc/pureftpd.pdb by default, but
99 +this reads /etc/ftp/pureftpd.passwd and creates /etc/ftp/pureftpd.pdb by default, but
100 to read another file, add the pdb file, optionnaly followed by -f <passwd file>
103 @@ -244,13 +244,13 @@
105 You can also change something to the text passwords file (add users, change
106 password, delete users, etc) and automatically run
107 -"pure-pw mkdb /etc/pureftpd.pdb" afterwards. To do so, just use the -m
108 +"pure-pw mkdb /etc/ftp/pureftpd.pdb" afterwards. To do so, just use the -m
111 pure-pw passwd joe -m
113 This command will change Joe's password in pureftpd.passwd *and* commit the
114 -change to /etc/pureftpd.pwd .
115 +change to /etc/ftp/pureftpd.pwd .
118 ------------------------ ENABLING VIRTUAL USERS ------------------------
120 Let's run the server with automatic creation of home directories and puredb
123 -/usr/local/sbin/pure-ftpd -j -lpuredb:/etc/pureftpd.pdb &
124 +/usr/local/sbin/pure-ftpd -j -lpuredb:/etc/ftp/pureftpd.pdb &
126 Try to 'ftp localhost' and log in as joe.
132 - pure-pwconvert >> /etc/pureftpd.passwd
133 + pure-pwconvert >> /etc/ftp/pureftpd.passwd
136 If you do it as a non-privileged user, passwords won't be filled in. If you
139 If defined, a PURE_PASSWDFILE environment variable can set the default path
140 to the pureftpd.passwd file. Without this variable, it defaults to
141 -/etc/pureftpd.passwd .
142 +/etc/ftp/pureftpd.passwd .
144 If defined, a PURE_DBFILE environment variable can set the default path
145 to the pureftpd.pdb file. Without this variable, it defaults to
147 +/etc/ftp/pureftpd.pdb .