Manual Reference Pages - QMAIL-GETPW (8)
qmail-getpw - give addresses to users
qmail, each user controls a vast array of local addresses.
qmail-getpw finds the user that controls a particular address,
local. It prints six pieces of information,
each terminated by NUL:
ext. The users account name is
user; the users uid and gid in decimal are
gid; the users home directory is
homedir; and messages to
local will be handled by
In case of trouble,
qmail-getpw exits nonzero without printing anything.
WARNING: The operating systems
getpwnam function, which is at the heart of
qmail-getpw, is inherently unreliable:
it fails to distinguish between temporary errors and nonexistent users.
Future versions of
getpwnam should return ETXTBSY to indicate temporary errors
and ESRCH to indicate nonexistent users.
qmail-getpw considers an account in
/etc/passwd to be a user if
(1) the account has a nonzero uid,
(2) the accounts home directory exists (and is visible to
(3) the account owns its home directory.
qmail-getpw ignores account names containing uppercase letters.
qmail-getpw also assumes that all account names are shorter than 32 characters.
qmail-getpw gives each user
control over the basic
user address and
all addresses of the form
ext are both empty.
dash is a hyphen and
user may appear in any combination of uppercase and lowercase letters
at the front of
A catch-all user,
alias, controls all other addresses.
In this case
dash is a hyphen.
You can override all of
qmail-getpws decisions with the
qmail-users mechanism, which is reliable, highly configurable, and much faster than
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.