---

argument_specs:

  main:
    version_added: "0.0.1"
    short_description: Install and configure PostSRSd.
    description:
      - Install and configure the L(PostSRSd,https://github.com/roehling/postsrsd) rewriting daemon.
      - "Execution of this role can be limited using the following tags:"
      - "C(role::postsrsd:install): Install PostSRSd."
      - "C(role::postsrsd:config): Render the PostSRSd configuration file."
      - "C(role::postsrsd): Apply all of the above."
    author: s3lph
    options:
      postsrsd_domain:
        description:
          - Set domain name for rewrite.
        type: str
        required: true
      postsrsd_exclude_domains:
        description:
          - Exclude additional domains from address rewriting.
        type: list
        elements: str
        default: []
      postsrsd_separator:
        description:
          - Set first separator character which can be one of C(-=+).
        type: str
        default: '='
      postsrsd_secret:
        description:
          - Read secrets from file.
        type: str
        default: /etc/postsrsd.secret
      postsrsd_hashlength:
        description:
          - Length of hash to be used in rewritten addresses.
        type: str
        default: 4
      postsrsd_hashmin:
        description:
          - Minimum length of hash to accept when validating return addresses.
        type: str
        default: 4
      postsrsd_forward_port:
        description:
          - Set port for the forward SRS lookup.
        type: str
        default: 10001
      postsrsd_reverse_port:
        description:
          - Set port for the reverse SRS lookup.
        type: str
        default: 10002
      postsrsd_runas:
        description:
          - Switch user id after port bind.
        type: str
        default: postsrsd
      postsrsd_listen_addr:
        description:
          - Bind to this address.
        type: str
        default: 127.0.0.1
      postsrsd_chroot:
        description:
          - Jail daemon in chroot environment.
        type: str
        default: /var/lib/postsrsd