SYNOPSIS

schleuder-newlist [-c baseconfig] [email protected]
~~~~~~~~~~~~~~~~~~[-realname "Foo List"]
~~~~~~~~~~~~~~~~~~[-adminaddress [email protected]]
~~~~~~~~~~~~~~~~~~[-initmember [email protected]
~~~~~~~~~~~~~~~~~~~-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 disabled, 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 [email protected]

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 [email protected]

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 -publickeyfile 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 [email protected]. A new keypair will be generated for the list.

  schleuder-newlist [email protected] \
      -realname "bal jak" \
      -adminaddress [email protected] \
      -initmember [email protected] -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 [email protected] \
      -realname "bal jak" \
      -adminaddress [email protected] \
      -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.