summaryrefslogtreecommitdiff
path: root/sqmail-4.3.07/man/qmail-getpw.9
diff options
context:
space:
mode:
Diffstat (limited to 'sqmail-4.3.07/man/qmail-getpw.9')
-rw-r--r--sqmail-4.3.07/man/qmail-getpw.9114
1 files changed, 0 insertions, 114 deletions
diff --git a/sqmail-4.3.07/man/qmail-getpw.9 b/sqmail-4.3.07/man/qmail-getpw.9
deleted file mode 100644
index c246b0e..0000000
--- a/sqmail-4.3.07/man/qmail-getpw.9
+++ /dev/null
@@ -1,114 +0,0 @@
-.TH s/qmail: qmail-getpw 8
-.SH NAME
-qmail-getpw \- give addresses to users
-.SH SYNOPSIS
-.B qmail-getpw
-.I local
-.SH DESCRIPTION
-In
-.BR s/qmail ,
-each user controls a vast array of local addresses.
-.B qmail-getpw
-finds the user that controls a particular address,
-.IR local .
-It prints six pieces of information,
-each terminated by NUL:
-.IR user ;
-.IR uid ;
-.IR gid ;
-.IR homedir ;
-.IR dash ;
-and
-.IR ext .
-The user's account name is
-.IR user ;
-the user's uid and gid in decimal are
-.I uid
-and
-.IR gid ;
-the user's home directory is
-.IR homedir ;
-and messages to
-.I local
-will be handled by
-.IR homedir\fB/.qmail\fIdashext .
-
-In case of trouble,
-.B qmail-getpw
-exits nonzero without printing anything.
-
-.B WARNING:
-The operating system's
-.B getpwnam
-function, which is at the heart of
-.BR qmail-getpw ,
-is inherently unreliable:
-it fails to distinguish between temporary errors and nonexistent users.
-Future versions of
-.B getpwnam
-should return ETXTBSY to indicate temporary errors
-and ESRCH to indicate nonexistent users.
-.SH "RULES"
-.B qmail-getpw
-considers an account in
-.B /etc/passwd
-to be a user if
-(1) the account has a nonzero uid,
-(2) the account's home directory exists (and is visible to
-.BR qmail-getpw ),
-and
-(3) the account owns its home directory.
-.B qmail-getpw
-ignores account names containing uppercase letters.
-.B qmail-getpw
-also assumes that all account names are shorter than 32 characters.
-
-.B qmail-getpw
-gives each user
-control over the basic
-.I user
-address and
-all addresses of the form
-.IR user\fBBREAK\fIanything .
-When
-.I local
-is
-.IR user ,
-.I dash
-and
-.I ext
-are both empty.
-When
-.I local
-is
-.IR user\fBBREAK\fIanything ,
-.I dash
-is a hyphen and
-.I ext
-is
-.IR anything .
-.I user
-may appear in any combination of uppercase and lowercase letters
-at the front of
-.IR local .
-
-A catch-all user,
-.BR alias ,
-controls all other addresses.
-In this case
-.I ext
-is
-.I local
-and
-.I dash
-is a hyphen.
-
-You can override all of
-.BR qmail-getpw 's
-decisions with the
-.B qmail-users
-mechanism, which is reliable, highly configurable, and much faster than
-.BR qmail-getpw .
-.SH "SEE ALSO"
-qmail-users(5),
-qmail-lspawn(8)