| Courier-Authlib | | | Home | | | Release notes | | | Installation | | | Documentation |
userdb — manipulate /usr/local/etc/authlib/userdb
userdb {addr} set {field=value...}
userdb {addr} unset {field...}
userdb {addr} del
userdb {path/addr} [ set | unset |
del ] ...
userdb -f {file} {adr} [ set | unset | del ]
...
userdb -show {path}
userdb -show {path} {addr}
userdb -show -f {file}
userdb -show -f {file} {addr}
userdb is a
convenient script to individually manipulate entries in
/usr/local/etc/authlib/userdb.
See makeuserdb(8) for a
description of its contents. /usr/local/etc/authlib/userdb can always be
edited using any text editor, but userdb is a convenient way
to modify this file from another script.
/usr/local/etc/authlib/userdb can also be a
subdirectory, instead of a file. Specify foo/bar/addraddr/usr/local/etc/authlib/userdb.
You can also use the /foo/bar-f flag:
-f
is equivalent. Use whatever form makes the most sense to
you./usr/local/etc/authlib/userdb/foo/bar
/usr/local/etc/authlib/userdb must not have
any group or world permissions. That's because its contents
may include system passwords (depending upon the application
which uses this virtual user account database).
Each line in /usr/local/etc/authlib/userdb takes
following form:
addr<TAB>field=value|field=value...
addr specifies a
unique virtual address. It is followed by a single tab
character, then a list of field=value pairs, separated by
vertical slash characters. See makeuserdb(8) for field
definitions.
A text editor can be used to add blank lines or comments
in /usr/local/etc/authlib/userdb. Any blank
lines or comments are ignored by the userdb script.
The names of the actual fields, and their contents, are
defined entirely by applications that use the /usr/local/etc/authlib/userdb database, the
userdb command
just adds or removes arbitrary fields.
For example:
userdb default/info set mail=/home/mail/info
This command accesses the address "info" in /usr/local/etc/authlib/userdb/default.
If the second argument to userdb is "set", the remaining arguments
are taken as field=valueaddr. If there is no record
for addr, a new
record will be appended to the file. If addr exists, any existing
values of any specified fields are removed. If = is missing,
userdb stops
and prompts for it. This is useful if you're setting a
password field, where you do not want to specify the password
on the command line, which can be seen by the ps(1) command. If userdb is being executed by
a script, the value can be provided on standard input.value
Use "unset" to
delete fields from an existing record. Use "del" to delete all fields in
the existing record, plus the record itself.
/usr/local/etc/authlib/userdbIf the first argument to userdb is -show, userdb displays the
contents of /usr/local/etc/authlib/userdb. If
/usr/local/etc/authlib/userdb
is a subdirectory, path/usr/local/etc/authlib/userdb. The
-f option can be
used instead of path
If addraddr/usr/local/etc/authlib/userdb for this
addr
addr
userdb postmaster@test.испытание set \
home=/home/postmaster.test.com uid=999 gid=999
/usr/local/etc/authlib/userdb.datThe actual virtual account/address database is
/usr/local/etc/authlib/userdb.dat. This
is a binary database file. /usr/local/etc/authlib/userdb
is the plain text version. After running userdb, execute the
makeuserdb(8) command to
rebuild /usr/local/etc/authlib/userdb.dat for the
changes to take effect.
addr/usr/local/etc/authlib/userdb is a
subdirectory, it's possible to create the same addr