GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
SYMPA(1) sympa 6.2.62 SYMPA(1)

sympa, sympa.pl - Command line utility to manage Sympa

"sympa.pl""-d, --debug" ] [ "-f, --file"=another.sympa.conf ] [ "-l, --lang"=lang ] [ "-m, --mail" ] [ "-h, --help" ] [ "-v, --version" ]

"--import"=listname ] [ "--open_list"=list[@robot] [--notify] ] [ "--close_list"=list[@robot] ] [ "--purge_list"=list[@robot] ] [ "--lowercase" ] [ "--make_alias_file" ] [ "--dump_users" "--list"=list@domain|ALL [ "--role"=roles ] ] [ "--restore_users" "--list"=list@domain|ALL [ "--role"=roles ] ] [ "--show_pending_lists"=robot ] [ "--rebuildarc"=list[@robot] ]

NOTE: On overview of Sympa documentation see sympa_toc(1).

Sympa.pl is invoked from command line then performs various administration tasks.

sympa.pl may run with following options in general.
"-d", "--debug"
Enable debug mode.
"-f", "--config="file
Force Sympa to use an alternative configuration file instead of /usr/local/etc/sympa/sympa.conf.
"-l", "--lang="lang
Set this option to use a language for Sympa. The corresponding gettext catalog file must be located in $LOCALEDIR directory.
"--log_level="level
Sets Sympa log level.

With the following options sympa.pl will run in batch mode:

"--add_list="family_name "--robot="robot_name "--input_file="/path/to/file.xml
Add the list described by the file.xml under robot_name, to the family family_name.
"--change_user_email" "--current_email="xx "--new_email="xx
Changes a user email address in all Sympa databases (subscriber_table, list config, etc) for all virtual robots.
"--close_family="family_name "--robot="robot_name
Close lists of family_name family under robot_name.
"--close_list="list[@robot]
Close the list (changing its status to closed), remove aliases and remove subscribers from DB (a dump is created in the list directory to allow restoring the list)
"--conf_2_db"
Load sympa.conf and each robot.conf into database.
"--copy_list="listname@robot "--new_listname="newlistname "--new_listrobot="newrobot
Copy a list.
"--create_list" "--robot="robot_name "--input_file="/path/to/file.xml
Create a list with the XML file under robot robot_name.
"--dump="list@domain|"ALL"
Obsoleted option. Use "--dump_users".
"--dump_users" "--list="list@domain|"ALL" [ "--role="roles ]
Dumps users of a list or all lists.

"--role" may specify "member", "owner", "editor" or any of them separated by comma (","). Only "member" is chosen by default.

Users are dumped in files role".dump" in each list directory.

Note: On Sympa prior to 6.2.31b.1, subscribers were dumped in subscribers.db.dump file, and owners and moderators could not be dumped.

See also "--restore_users".

Note: This option replaced "--dump" on Sympa 6.2.34.

"--health_check"
Check if sympa.conf, robot.conf of virtual robots and database structure are correct. If any errors occur, exits with non-zero status.
"--import="list@dom
Import subscribers in the list. Data are read from standard input. The imported data should contain one entry per line : the first field is an email address, the second (optional) field is the free form name. Fields are spaces-separated.

Use "--quiet" to prevent welcome emails.

Sample:

    ## Data to be imported
    ## email        gecos
    john.steward@some.company.com           John - accountant
    mary.blacksmith@another.company.com     Mary - secretary
    
"--instantiate_family="family_name "--robot="robot_name "--input_file="/path/to/file.xml [ "--close_unknown" ] [ "--quiet" ]
Instantiate family_name lists described in the file.xml under robot_name. The family directory must exist; automatically close undefined lists in a new instantiation if --close_unknown is specified; do not print report if "--quiet" is specified.
"--lowercase"
Lowercases email addresses in database.
"--make_alias_file" [ "--robot" robot ]
Create an aliases file in /tmp/ with all list aliases. It uses the list_aliases.tt2 template (useful when list_aliases.tt2 was changed).
"--md5_encode_password"
Rewrite password in "user_table" of database using MD5 fingerprint. YOU CAN'T UNDO unless you save this table first.

Note that this option was obsoleted. Use upgrade_sympa_password(1).

"--modify_list="family_name "--robot="robot_name "--input_file="/path/to/file.xml
Modify the existing list installed under the robot robot_name and that belongs to the family family_name. The new description is in the "file.xml".
"--open_list="list[@robot] [--notify]
Restore the closed list (changing its status to open), add aliases and restore users to DB (dump files in the list directory are imported).

The "--notify" is optional. If present, the owner(s) of the list will be notified.

"--purge_list"=list[@robot]
Remove the list (remove archive, configuration files, users and owners in admin table. Restore is not possible after this operation.
"--show_pending_lists"=robot
Print all pending lists for the robot, with informations.
"--rebuildarc"=list[@robot]
Rebuild the archives of the list.
"--reload_list_config" [ "--list="mylist@mydom ] [ "--robot="mydom ]
Recreates all config.bin files or cache in "list_table". You should run this command if you edit authorization scenarios. The list and robot parameters are optional.
"--rename_list="listname@robot "--new_listname="newlistname "--new_listrobot="newrobot
Renames a list or move it to another virtual robot.
"--send_digest" [ "--keep_digest" ]
Send digest right now. If "--keep_digest" is specified, stocked digest will not be removed.
"--restore_users" "--list="list@domain|"ALL" [ "--role="roles ]
Restore users from files dumped by "--dump_users".

Note: This option was added on Sympa 6.2.34.

"--sync_include="listname@robot [ "--role="role ]
Trigger update of the list users included from data sources.
"--sync_list_db" [ "--list="listname@robot ]
Syncs filesystem list configs to the database cache of list configs, optionally syncs an individual list if specified.
"--test_database_message_buffer"
Note: This option was deprecated.

Test the database message buffer size.

"--upgrade" [ "--from="X ] [ "--to="Y ]
Runs Sympa maintenance script to upgrade from version X to version Y.
"--upgrade_shared" [ "--list="X ] [ "--robot="Y ]
Note: This option was deprecated. See upgrade_shared_repository(1).

Rename files in shared.

With following options sympa.pl will print some information and exit.

"-h", "--help"
Print this help message.
"--md5_digest="password
Output a MD5 digest of a password (useful for SOAP client trusted application).
"-v", "--version"
Print the version number.

/usr/local/etc/sympa/sympa.conf main configuration file.

sympa_toc(1).

This program was originally written by:
Serge Aumont
Comite Reseau des Universites
Olivier Salauen
Comite Reseau des Universites

As of Sympa 6.2b.4, it was split into three programs: sympa.pl command line utility, sympa_automatic.pl daemon and sympa_msg.pl daemon.

2022-05-14 6.2.62

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.