.TH bincimapd 1
.SH "NAME"
bincimapd \- IMAP4rev1 server
.SH "SYNOPSIS"
.B bincimap-up [options] -- <authenticator> bincimapd <maildepot>

.B bincimap-up -- SQMAIL/bin/qmail-authuser bincimapd Maildir
.SH "DESCRIPTION"
.B bincimapd 
implements the IMAP interface to the user's 
.I <maildepot>
by name which could be
.I Maildir++
or 
.I IMAPdir 
structured.
Upon invocation
.B bincimapd
switches to the home directory available by the user environment 
and performs the commanded IMAP operations on the given
.IR <maildepot> .
.SH "CONFIGURATION"
.B bincimapd
shares the same environment variables with
.BR bincimap-up ,
thus there is no specific configuration required and therefore
.I [...]
is usually avoided, except for
its first unqualified argument containing the name of the 
mailbox depository in which
.B bincimapd 
should search for folders. If unset, some authenticators like
.B qmail-authuser
and 
.B vmailmgr
will fail. However, 
.B bincimapd 
runs in the environment of the user and honors the
a specific setting of environment variables to cope 
local preferences.
.SH "COMPLIANCE"
.B bincimapd
conforms partially to IMAP4rev1 (RFCs 3501, 2177 [Idle], 2341 [Namespace], 
2971 [Id]).
Alphabetic list of supported IMAP commands:
.IP \[bu] 2
Append
.IP \[bu] 2 
Authenticate
.IP \[bu] 2 
Capability
.IP \[bu] 2 
Check
.IP \[bu] 2 
Close
.IP \[bu] 2 
Copy
.IP \[bu] 2 
Create
.IP \[bu] 2 
Delete
.IP \[bu] 2 
Examine
.IP \[bu] 2 
Expunge
.IP \[bu] 2 
Fetch
.IP \[bu] 2 
Id
.IP \[bu] 2 
Idle
.IP \[bu] 2 
List
.IP \[bu] 2 
Login
.IP \[bu] 2 
Logout
.IP \[bu] 2 
Lsub
.IP \[bu] 2 
Namespace
.IP \[bu] 2 
Noop
.IP \[bu] 2 
Rename
.IP \[bu] 2 
Search
.IP \[bu] 2 
Select
.IP \[bu] 2 
Starttls
.IP \[bu] 2 
Status
.IP \[bu] 2 
Store
.IP \[bu] 2 
Subscribe
.IP \[bu] 2 
Unsubscribe
.SH "FILES"
Within every
.I <maildepot>
subdirectory
.B bincimpad
generates a set of files 
.TP
.I $HOME/<maildepot>/.../bincimap-uidvalidity
This file contains a version number, the
.BR UIDNEXT ,
and
.B UIDVALIDITY
values for the given mailbox.
.TP
.I $HOME/<maildepot>/.../bincimap-cache
This file contains a version number, and it stores the
.B UID
values for each message, along with (optionally) some cached
information.

.RE
Exception:
.TP  
.I $HOME/<maildepot>/.subscribed
All subscribed <mailboxes> are included here. 
.SH "LOGGING" 
After the user login
.B bincimapd 
displays the 
.IR PID , 
.IR userid , 
and
.I IP address.
On logout or disconnect
it provides the 
.IR PID ,
the number of messages fetched
.IR Bodies:\ n , 
and the number of IMAP commands executed
.IR Statements:\ m . 
.SH "COPYRIGHT"
Copyright (C) 2002-2005 Andreas Aardal Hanssen, 2023 Erwin Hoffmann

This is free software; see the LICENSE for copying conditions. 
There is NO warranty.
.SH "SEE ALSO"
bincimap(1), bincimap-up(1),
multilog(8), supervise(8), tcpserver(1), sslserver(1),
qmail-authuser(7)