X-Git-Url: https://git.hcoop.net/hcoop/debian/courier-authlib.git/blobdiff_plain/8d138742ae268344f406cb75d79aa6bf853f9d87..b0322a8536f3cab76471c98122fe1df75bb7c387:/userdb/userdb.html.in diff --git a/userdb/userdb.html.in b/userdb/userdb.html.in index 32d6b01..c5c3012 100644 --- a/userdb/userdb.html.in +++ b/userdb/userdb.html.in @@ -1,10 +1,10 @@ -userdb

Name

userdb — manipulate @userdb@

Synopsis

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}

DESCRIPTION

+-->

Name

userdb — manipulate @userdb@

Synopsis

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}

DESCRIPTION

userdb is a convenient script to individually manipulate entries in @userdb@. See makeuserdb(8) @@ -23,11 +23,9 @@ whatever form makes the most sense to you.

permissions. That's because its contents may include system passwords (depending upon the application which uses this virtual user account database).

-Each line in @userdb@ takes following form: -

- +Each line in @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 @@ -64,7 +62,7 @@ command. If userdb is being executed by a script, the value can be provided on standard input.

Use "unset" to delete fields from an existing record. Use "del" to delete all fields in the existing record, -plus the record itself.

DISPLAYING @userdb@

+plus the record itself.

DISPLAYING @userdb@

If the first argument to userdb is -show, userdb displays the contents of @userdb@. If @@ -82,13 +80,13 @@ output, containing all addresses found in the file, on per line. If addr is specified, userdb produces a list, on standard output, of all the fields in @userdb@ for this -addr.

REBUILDING @userdb@.dat

+addr.

REBUILDING @userdb@.dat

The actual virtual account/address database is @userdb@.dat. This is a binary database file. @userdb@ is the plain text version. After running userdb, execute the makeuserdb(8) command to rebuild -@userdb@.dat for the changes to take effect.

BUGS

+@userdb@.dat for the changes to take effect.

BUGS

addr must be unique. If @userdb@ is a subdirectory, it's possible to create the same @@ -97,10 +95,10 @@ in different files in the subdirectory. This is an error that is not currently detected by userdb, however the subsequent makeuserdb(8) command -will fail with an error message.

FILES

+will fail with an error message.

FILES

@userdb@ - plain text file, or directory of plain text files

.lock.filename - lock file for filename

- .tmp.filename - temporary file used to create new contents of filename

SEE ALSO

+ .tmp.filename - temporary file used to create new contents of filename