SCHLEUDER-NEWLIST(8) SCHLEUDER-NEWLIST(8)
NAME
schleuder-newlist - create new Schleuder mailing list
SYNOPSIS
schleuder-newlist [-c baseconfig] newlist@example.net
[-realname "Foo List"]
[-adminaddress listadmin@example.net]
[-initmember member1@example.net
-initmemberkey path-to-initmember-publickey]
[-privatekeyfile path-to-privatekey
-publickeyfile path-to-publickey
-passphrase "key passphrase"]
[-mailuser schleuder]
[-nointeractive]
DESCRIPTION
schleuder-newlist automates the creation of new Schleuder mailing lists. For more information on Schleuder, please look at schleuder(8).
schleuder-newlist does various input validation, and can generate a key or import one. It will give you as well an easy interface to build
new lists in a scripted manner.
It also supports an interactive mode, with which the user will be prompted for missing mandatory options. The interactive mode can be dis-
abled, using the -nointercative flag; it is automatically disabled if the script isn't run within a valid tty.
If no -privatekeyfile, -publickeyfile and -passphrase are provided, the list will create a new keypair with a random password. The type and
length of the generated keypair is specified in /etc/schleuder/schleuder.conf.
OPTIONS
-c path-to-schleuder-configuration:
Specify an alternate configuration directory than the default /etc/schleuder.
-realname "Foo List"
Specify the name of the mailing list.
-adminaddress listadmin@example.net
Specify the email address of a list administrator. This address will be notified of errors, and depending on configuration may also
be allowed to send restricted email commands.
-initmember member1@example.net
Specify the first subscribed list member address. Can be the same as the administrator address. This option must be accompanied by
-initmemberkey.
-initmemberkey path-to-initmember-publickey
Specify the path to first subscribed list member public key. -initmember must also be specified.
-privatekeyfile path-to-privatekey
Specify the path to a previously-generated private key for the list. This option must be accompanied by -publickeyfile and
-passphrase.
-publickeyfile path-to-publickey
Specify the path to a previously-generated public key for the list. This option must be accompanied by -privatekeyfile and
-passphrase.
-passphrase "key passphrase"
Specify the passphrase needed to access the private key specified in -privatekeyfile. This option must be accompanied by -publickey-
file as well.
-mailuser schleuder
Specify the system user account under which schleuder(8) will be executed (when run as root, this defaults to schleuder).
-nointeractive
When specified, no questions will be asked to complete missing information.
EXAMPLES
This creates a new list called test1 with the initial member foo@bar.ch. A new keypair will be generated for the list.
schleuder-newlist foobar@example.org
-realname "bal jak"
-adminaddress admin@example.org
-initmember foo@example.com -initmemberkey /tmp/foo.pub
The list test2 will be created, a keypair from the following files with the passphrase test will be imported.
schleuder-newlist test2@example.com
-realname "bal jak"
-adminaddress foobar@example.org
-privatekeyfile ~/tmp/test2.priv
-publickeyfile /tmp/test2.pub
-passphrase test
FILES
/etc/schleuder/schleuder.conf
global Schleuder configuration
/etc/schleuder/default-list.conf
default list settings
/var/schleuderlists/HOSTNAME/LISTNAME
list internal data
/var/schleuderlists/HOSTNAME/LISTNAME/list.conf
list settings
/var/schleuderlists/HOSTNAME/LISTNAME/members.conf
list susbcribers
All configuration files are formatted as YAML. See http://www.yaml.org/ for more details.
BUGS
Known bugs are listed on the Schleuder website.
SEE ALSO
schleuder(8), aliases(5), gnupg(7).
Schleuder website
http://schleuder.nadir.org/
YAML website
http://www.yaml.org/
June 2012 SCHLEUDER-NEWLIST(8)