inquerytest.8

NAME

inquerytest - Test InLookup Queries

SYNOPSYS

inquerytest [options] email [domain_name]

DESCRIPTION

inquerytest is a utility to test the inquery() function and its interaction with InLookup(8). This function is meant to be used by qualified IndiMail administrators.

OPTIONS

-v
Set Verbose mode

-q query_type
Type of query to be tested as given below

1 – User Query This displays the status of the user, whether the id has all service enabled or is absent, inactive or over quota 2 – Relay Query Tells whether the user has authenticated and the entry is present in the relay table and has not expired (used for POP before SMTP). 3 – Password Query Displays the passwd structure for the email address. 4 – Host Query Displays the SMTPROUTE for the address. i.e. To which host should the mails for this address be delivered. 5 – Alias Query Displays all the aliases, forwarding, vacation entries for the address. 6 - Domain Limit Query Displays Domain limits for the domain portion of email. 7 – Local Password Query Similar to (3) except that the email address is checked only on the local MDA..

-i infifo
Path of the fifo to be used for communication with InLookup. A null string (“”) makes inquerytest to use INFIFO environment variable if defined, or the default file named "infifo". INFIFO can be a full path in which case the value of INFIFO will be used. If INFIFO is not a full path, the file defined by INFIFO env variable will be looked in the diretory defined by the INFIFODIR environment variable. If INFIFODIR is not defined, /run/indimail/inlookup directory will be used as a default.

inquerytest will directly use a fifo path if it exists. Else inquerytest will invoke a new InLookup on the given fifo, run the test, terminate InLookup and delete the fifo after the test.

email
Fully qualified email address.

ip_address
IP address (TCPREMOTEIP) recorded in relay table after successful authentication through IMAP/POP3 for the email address email. This option is valid for the Host Query type.

EXAMPLE USAGE

$ sudo setuidgid -g qmail qmaild mkdir -p /tmp/inquerytest
$ sudo setuidgid -g qmail qmaild env FIFOTMPDIR=/tmp/inquerytest FIFO_MODE=0666 /usr/sbin/inquerytest -v -q 3 -i "" testuser02@example.com

RETURN VALUE

0 for success, 1 for any failure. Prints diagnostics on stdout and failures on stderr.

SEE ALSO

inlookup(8)