Doc

# Uses the "postconf" command to add/alter/remove options in postfix main

# configuation file (/etc/postfix/main.cf).

#

#Parameters:

#- *name*: name of the parameter.

#- *ensure*: present/absent. defaults to present.

#- *value*: value of the parameter.

# === Parameters

#

#Requires:

#- Class["postfix"]

# [*name*]   - name of the parameter.

# [*ensure*] - present/absent. defaults to present.

# [*value*]  - value of the parameter.

#

#Example usage:

# === Requires

#

#  node "toto.example.com" {

# - Class["postfix"]

#

#    include postfix

# === Examples

#

#    postfix::config {

#      "smtp_use_tls"            => "yes";

#      "smtp_sasl_auth_enable"   => "yes";

#      "smtp_sasl_password_maps" => "hash:/etc/postfix/my_sasl_passwords";

#      "relayhost"               => "[mail.example.com]:587";

#   postfix::config { 'smtp_use_tls':

#     ensure => 'present',

#     value  => 'yes',

#   }

#  }

#

#

define postfix::config ($value, $ensure = present) {

# "${name}.db" using the "postmap" command. The map file can then be referred to

# using postfix::config.

#

#Parameters:

#- *name*: the name of the map file.

#- *ensure*: present/absent, defaults to present.

#- *source*: file source.

# === Parameters

#

#Requires:

#- Class["postfix"]

# [*name*]   - the name of the map file.

# [*ensure*] - present/absent, defaults to present.

# [*source*] - file source.

#

#Example usage:

# === Requires

#

#  node "toto.example.com" {

# - Class["postfix"]

#

#    include postfix

# === Examples

#

#    postfix::hash { "/etc/postfix/virtual":

#   postfix::hash { '/etc/postfix/virtual':

#     ensure => present,

#   }

#    postfix::config { "virtual_alias_maps":

#      value => "hash:/etc/postfix/virtual"

#    }

#   postfix::config { 'virtual_alias_maps':

#     value => 'hash:/etc/postfix/virtual',

#   }

#

define postfix::hash (

# == Class: postfix::ldap

#

# Configures postfix for use with LDAP.

#

# === Parameters

#

# === Requires

#

# - Class["postfix"]

#

# === Examples

#

# include postfix

# include postfix::ldap

#

class postfix::ldap {

  package {'postfix-ldap': }

# Configures a basic smtp server, able to work for the mailman mailing-list

# manager.

#

# Example usage:

# === Examples

#

#   node 'toto.example.com' {

#     class { '::postfix':

# /!\ Do not include this class directly,

# use mailman => true in the postfix top class!

#

#   class { 'postfix':

#     mailman => true,

#   }

#   }

#

# /!\ Do not include this class directly anymore,

# use mailman => true in the postfix top class!

class postfix::mailman {

  postfix::config {

#

# == Class: postfix::mta

#

# This class configures a minimal MTA, listening on

# $postfix_smtp_listen (default to localhost) and delivering mail to

# $postfix_mydestination (default to $fqdn).

# This class configures a minimal MTA, delivering mail to

# $mydestination.

#

# A valid relay host is required ($postfix_relayhost) for outbound email.

# A valid relay host is required ($relayhost) for outbound email.

#

# transport & virtual maps get configured and can be populated with

# postfix::transport and postfix::virtual

#

# Parameters:

# - *$postfix_relayhost*

# - *$postfix_mydestination*

# - every global variable which works for class 'postfix' will work here.

#

# Example usage:

# === Parameters

#

#   node 'toto.example.com' {

#     $postfix_relayhost = 'mail.example.com'

#     $postfix_smtp_listen = '0.0.0.0'

#     $postfix_mydestination = '$myorigin, myapp.example.com'

# [*relayhost*]     - (string) the relayhost to use

# [*mydestination*] - (string)

# [*mynetworks*]    - (string)

#

#     include postfix::mta

# === Examples

#

#     postfix::transport { 'myapp.example.com':

#       ensure => present,

#       destination => 'local:',

#     }

#   class { 'postfix':

#     relayhost     => 'mail.example.com',

#     smtp_listen   => '0.0.0.0',

#     mydestination => '$myorigin, myapp.example.com',

#     mta           => true,

#   }

#

class postfix::mta (