Contents

• • 1.1 License
  • 1.2 Features
  • 1.3 Project directions
  • 1.4 History
  • 1.5 Authors and credits
  • 1.6 Mailing lists and support
  • 2.1 Organization
  • 2.2 Binaries
  • 2.3 Configuration files
  • 2.4 Spools
  • 3.1 Obtaining Sympa, related links
  • 3.2 Prerequisites
    • 3.2.1 System requirements
    • 3.2.2 Install Berkeley DB (NEWDB)
    • 3.2.3 Install PERL and CPAN modules
    • 3.2.4 Required CPAN modules
    • 3.2.5 Create a UNIX user
  • 3.3 Compilation and installation
    • 3.3.1 Choosing directory locations
  • 3.4 Robot aliases
  • 3.5 Logs
  • 3.6 sympa.pl
  • 4.1 Site customization
    • 4.1.1 host
    • 4.1.2 email
    • 4.1.3 listmaster
    • 4.1.4 wwsympa_url
    • 4.1.5 dark_color light_color text_color bg_color error_color selected_color shaded_color
    • 4.1.6 cookie
    • 4.1.7 create_list
  • 4.2 Directories
    • 4.2.1 home
    • 4.2.2 etc
  • 4.3 System related
    • 4.3.1 syslog
    • 4.3.2 log_socket_type
    • 4.3.3 pidfile
    • 4.3.4 umask
  • 4.4 Sending related
    • 4.4.1 maxsmtp
    • 4.4.2 log_smtp
    • 4.4.3 max_size
    • 4.4.4 misaddressed_commands
    • 4.4.5 nrcpt
    • 4.4.6 avg
    • 4.4.7 sendmail
    • 4.4.8 sendmail_args
    • 4.4.9 rfc2369_header_fields
    • 4.4.10 remove_headers
    • 4.4.11 anonymous_headers_fields
    • 4.4.12 list_check_smtp
    • 4.4.13 list_check_suffixes
  • 4.5 Spool related
    • 4.5.1 spool
    • 4.5.2 queue
    • 4.5.3 queuemod
    • 4.5.4 queuedigest
    • 4.5.5 queueexpire
    • 4.5.6 queueauth
    • 4.5.7 queueoutgoing
    • 4.5.8 queuebounce
    • 4.5.9 queuetask
    • 4.5.10 tmpdir
    • 4.5.11 sleep
    • 4.5.12 clean_delay_queue
    • 4.5.13 clean_delay_queuemod
    • 4.5.14 clean_delay_queueauth
  • 4.6 Internationalization related
    • 4.6.1 msgcat
    • 4.6.2 lang
  • 4.7 Bounce related
    • 4.7.1 bounce_warn_rate
    • 4.7.2 bounce_halt_rate
    • 4.7.3 welcome_return_path
    • 4.7.4 remind_return_path
  • 4.8 Priority related
    • 4.8.1 sympa_priority
    • 4.8.2 request_priority
    • 4.8.3 owner_priority
    • 4.8.4 default_list_priority
  • 4.9 Database related
    • 4.9.1 db_type
    • 4.9.2 db_name
    • 4.9.3 db_host
    • 4.9.4 db_port
    • 4.9.5 db_user
    • 4.9.6 db_passwd
    • 4.9.7 db_options
    • 4.9.8 db_env
    • 4.9.9 db_additional_subscriber_fields
    • 4.9.10 db_additional_user_fields
  • 4.10 Loop prevention
    • 4.10.1 loop_command_max
    • 4.10.2 loop_command_sampling_delay
    • 4.10.3 loop_command_decrease_factor
  • 4.11 S/MIME configuration
    • 4.11.1 openssl
    • 4.11.2 trusted_ca_options
    • 4.11.3 key_passwd
    • 4.11.4 chk_cert_expiration_task
    • 4.11.5 crl_update_task
  • 4.12 Antivirus plug-in
    • 4.12.1 antivirus_path
    • 4.12.2 antivirus_args
  • 5.1 Organization
  • 5.2 HTTPD setup
    • 5.2.1 wwsympa.fcgi access permissions
    • 5.2.2 Installing wwsympa.fcgi in your Apache server
    • 5.2.3 Using FastCGI
  • 5.3 wwsympa.conf parameters
    • 5.3.1 alias_manager
    • 5.3.2 arc_path
    • 5.3.3 archive_default_index thrd | mail
    • 5.3.4 archived_pidfile
    • 5.3.5 bounce_path
    • 5.3.6 bounced_pidfile
    • 5.3.7 cookie_expire
    • 5.3.8 cookie_domain
    • 5.3.9 default_home
    • 5.3.10 icons_url
    • 5.3.11 log_facility
    • 5.3.12 mhonarc
    • 5.3.13 password_case sensitive | insensitive
    • 5.3.14 title
    • 5.3.15 use_fast_cgi 0 | 1
  • 5.4 MhOnArc
  • 5.5 Archiving daemon
  • 5.6 Database configuration
  • 6.1 Prerequisites
  • 6.2 Installing PERL modules
  • 6.3 Creating a sympa DataBase
    • 6.3.1 Database structure
    • 6.3.2 Database creation
  • 6.4 Importing subscribers data
    • 6.4.1 Importing data from a text file
    • 6.4.2 Importing data from subscribers files
  • 6.5 Extending database table format
  • 6.6 Sympa configuration
  • 7.1 Authentication via uid or alternate email
    • 7.1.1 auth.conf
  • 7.2 Named Filters
    • 7.2.1 Definition
    • 7.2.2 Search Condition
  • 8.1 Signed message distribution
  • 8.2 Use of S/MIME signature by Sympa itself
  • 8.3 Use of S/MIME encryption
  • 8.4 S/Sympa configuration
    • 8.4.1 Installation
    • 8.4.2 configuration in sympa.conf
    • 8.4.3 configuration to recognize S/MIME signatures
    • 8.4.4 distributing encrypted messages
  • 8.5 Managing certificates with tasks
    • 8.5.1 chk_cert_expiration.daily.task model
    • 8.5.2 crl_update.daily.task model
  • 9.1 How to create a virtual robot
  • 9.2 robot.conf
    • 9.2.1 Robot customization
  • 10.1 Template file format
    • 10.1.1 Variables
    • 10.1.2 Conditions
    • 10.1.3 Loops
    • 10.1.4 File inclusions
    • 10.1.5 Stop parsing
  • 10.2 Site template files
    • 10.2.1 helpfile.tpl
    • 10.2.2 lists.tpl
    • 10.2.3 global_remind.tpl
    • 10.2.4 your_infected_msg.tpl
  • 10.3 Web template files
  • 10.4 Sharing data with other applications
  • 10.5 Sharing WWSympa authentication with other applications
  • 10.6 Internationalization
    • 10.6.1 Sympa internationalization
    • 10.6.2 List internationalization
    • 10.6.3 User internationalization
  • 10.7 Topics
  • 10.8 Scenarii
    • 10.8.1 rules specifications
    • 10.8.2 scenario inclusion
  • 10.9 Loop detection
  • 10.10 Tasks
    • 10.10.1 List task creation
    • 10.10.2 Global task creation
    • 10.10.3 Model file format
    • 10.10.4 Model file examples
  • 11.1 Mail aliases
  • 11.2 List directory
  • 11.3 List configuration file
  • 11.4 Examples of configuration files
  • 11.5 Subscribers file
  • 11.6 Info file
  • 11.7 Homepage file
  • 11.8 List template files
    • 11.8.1 welcome.tpl
    • 11.8.2 bye.tpl
    • 11.8.3 removed.tpl
    • 11.8.4 reject.tpl
    • 11.8.5 invite.tpl
    • 11.8.6 remind.tpl
    • 11.8.7 summary.tpl
  • 11.9 Stats file
  • 11.10 List model files
    • 11.10.1 remind.annual.task
    • 11.10.2 expire.annual.task
  • 11.11 Message header and footer
    • 11.11.1 Archive directory
  • 12.1 List creation
    • 12.1.1 Who can create lists
    • 12.1.2 typical list profile
    • 12.1.3 creating list alias
  • 12.2 List edition
  • 13.1 List description
    • 13.1.1 editor
    • 13.1.2 host
    • 13.1.3 lang
    • 13.1.4 owner
    • 13.1.5 subject
    • 13.1.6 topics
    • 13.1.7 visibility
  • 13.2 Data source related
    • 13.2.1 user_data_source
    • 13.2.2 ttl
    • 13.2.3 include_list
    • 13.2.4 include_sql_query
    • 13.2.5 include_ldap_query
    • 13.2.6 include_ldap_2level_query
    • 13.2.7 include_file
  • 13.3 Command related
    • 13.3.1 subscribe
    • 13.3.2 unsubscribe
    • 13.3.3 add
    • 13.3.4 del
    • 13.3.5 remind
    • 13.3.6 remind_task
    • 13.3.7 expire_task
    • 13.3.8 send
    • 13.3.9 review
    • 13.3.10 shared_doc
  • 13.4 List tuning
    • 13.4.1 reply_to_header
    • 13.4.2 max_size
    • 13.4.3 anonymous_sender
    • 13.4.4 custom_header
    • 13.4.5 custom_subject
    • 13.4.6 footer_type
    • 13.4.7 digest
    • 13.4.8 available_user_options
    • 13.4.9 default_user_options
    • 13.4.10 cookie
    • 13.4.11 priority
  • 13.5 Bounce related
    • 13.5.1 bounce
    • 13.5.2 welcome_return_path
    • 13.5.3 remind_return_path
  • 13.6 Archive related
    • 13.6.1 archive
    • 13.6.2 web_archive
  • 14.1 The three kind of operations on a document
  • 14.2 The description file
    • 14.2.1 Structure of description files
  • 14.3 The predefined scenarii
    • 14.3.1 The public scenario
    • 14.3.2 The private scenario
    • 14.3.3 The scenario owner
  • 14.4 Access control
    • 14.4.1 Listmaster and privileged owners
    • 14.4.2 Special case of the shared directory
    • 14.4.3 General case
  • 14.5 Shared document actions
  • 14.6 Template files
    • 14.6.1 d_read.tpl
    • 14.6.2 d_editfile.tpl
    • 14.6.3 d_control.tpl
  • 17.1 User commands
  • 17.2 Owner commands
  • 17.3 Moderator commands