bincimap-up(1) General Commands Manual bincimap-up(1) NAME bincimap-up - Authentication stub for Binc IMAP SYNOPSIS bincimap-up [ options... ] -- <authenticator> bincimapd [mailboxpath] DESCRIPTION For more information about Binc IMAP, see the bincimapd man pages. To configure this stub, use either command line arguments, config file en- tries, or a combination of both. A subset of the config file options is available as command line options. Note that command line arguments always override config file options. OPTIONS -a, --allow-plain If set, allows plain text authentication in an unencrypted (SSL/TLS) IMAP session. --auth-penalty=<n> Server will sleep for <n> seconds if the client issues a user- name/password pair that fails to authenticate. -t, --auth-timeout=<n> When the server is in unauthenticated mode, and does not detect any client activity, it will wait <n> seconds before closing (t/o) the connection. <n> can not be less than 30 seconds. -f, --ca-file=<file> A file with one or more certificate authority certificates. It is used to help the client verify the SSL certificate. -P, --ca-path=<path> A path used by the underlying SSL support to search for files with certificate authorities. -l, --cipher-list=<ciphers> Sets the list of available SSL ciphers. -c, --conf=<file> Location of bincimap.conf file. -C, --create-inbox If set, server will create the default mailbox INBOX on first login if it does not exist. -C, --depot=[Maildir++|IMAPdir] Sets whether to use a Maildir++ or an IMAPdir depot. Default is Maildir++. -d, --disable-starttls Do not advertise the STARTTLS capability. Use this when running Binc IMAP in plain text over an already SSL encrypted tunnel. Default: no. -h, -?, --help Displays basic usage. -I, --ip-variable=<var> For logging, suggests an environment variable that contains the re- mote host IP address. -i, --idle-timeout=<n> When the server is in authenticated mode, and does not detect any client activity, it will wait <n> seconds before closing (t/o) the connection. <n> can not be less than 1800 seconds. -J, --jail-path=<path> Which path bincimap-up should chroot to after starting bincimapd. -K, --jail-user=<userid> Which user bincimap-up should become after starting bincimapd. -j, --jail-group=<groupid> Which user bincimap-up should become after starting bincimapd. -L, --logtype=[syslog|multilog] Which method Binc IMAP should use to log. syslog means to connect to syslog. multilog means to log to stderr(2). Typically used to- gether with the multilog utility. For xinetd, use syslog. For dae- montools/supervise, use multilog. Default: syslog. -m, --mailbox-path=<path> Path to mailbox relative from user's home area. Typically Maildir for Maildir mailboxes, or the empty string "" if the home area is equivalent to the Maildir directory. -M, --mailbox-type=<type> Which type of mailbox should the server use? Currently only supports Maildir. -p, --pem-file=<file> The path to the SSL certificate file, in PEM format. -s, --ssl If set, Binc will go straight into SSL server mode. If this option is not passed, Binc will still advertise STARTTLS, allowing clients to switch to SSL on need. Use --ssl if running Binc on port 993. -S, --subscribe-mailboxes=<mailboxes> If present, server will automatically subscribe client to the given list of mailboxes on first login. Mailbox list is given as a comma separated list with the mailbox' full path, for example INBOX,IN- BOX.Sent-Mail,INBOX.Trash -b, --transfer-buffersize=<n> The server will buffer up to <n> bytes of data before sending it off to the client. A lower value will give smoother response from the server, but is a bad idea for clients with a big RTT (for example dial-ins). A high value gives better throughput, but a more bulky transfer. -T, --transfer-timeout=<n> The server writes data to the client in bulks. Each bulk gets <n> seconds to complete before the server times out. -u, --umask=<umask> Server will use this umask throughout session. Defaults to user's default umask. -V, --verify-peer If set, server will attempt to verify peer certificate. -v, --version Shows Binc IMAP version. -- Marks the end of options to bincimap-up. After this comes the checkpassword compatible authenticator. (trailing arguments) Binc IMAP's authenticator. The first argument is invoked as an au- thenticator subprocess of Binc, with the rest of the arguments passed as the authenticator's local arguments. EXAMPLE INVOCATION The following example shows how to invoke Binc IMAP using multilog, with an example /opt location for the conf file and using checkpassword as the au- thenticator. Notice that both the authentication stub and the authenticated daemon must both have command line arguments, and that the authenticator comes after '--'. Also notice that after bincimapd comes the mailbox path. This is already set in bincimap.conf, so it's not necessary here, but shown only for the sake of demonstration. /opt/bincimap/bin/bincimap-up \ --conf=/opt/bincimap/etc/bincimap.conf \ -- \ /bin/checkpassword \ /opt/bincimap/bin/bincimapd Maildir You will typically invoke bincimapd from either xinetd or supervise. FILES All Binc IMAP's configuration files use the same Binc::Storage format. It's basically a sequence of named sections enclosed in {braces}, each contain- ing a set of comma separated key=value pairs. The keys must be alphanu- meric, and the values can contain any character if it's quoted. .I bincimap.conf Global configurations file. All entries in this file can be overrun with command line arguments. COPYRIGHT Copyright (C) 2002-2005 Andreas Aardal Hanssen This is free software; see the source for copying conditions. There is NO warranty. NOTE Please report any bugs to the Binc IMAP mailing list. Before posting your bug, check out the Binc IMAP official home page for a list of mailing list archives to browse. Mailing list: <binc@bincimap.org> Developers' mailing list: <binc-dev@bincimap.org> Announcements list: <binc-news@bincimap.org> Subscribing to a mailing list: <binc-subscribe@bincimap.org> Home page: http://www.bincimap.org/ AUTHOR Andreas Aardal Hanssen <andreas-binc@bincimap.org> SEE ALSO multilog(8) supervise(8) tcpserver(1) bincimapd(1) bincimap.conf(5) xinetd(8) xinetd.conf(5) Note: The first three man pages are available for download from http://www.qmail.org/. bincimap-up(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE INVOCATION | FILES | COPYRIGHT | NOTE | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bincimap-up&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>