diff --git a/README.md b/README.md index 84bde21..a13f636 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,177 @@ # xoxys.cups + +[![Build Status](https://drone.rknet.org/api/badges/ansible/xoxys.cups/status.svg)](https://drone.rknet.org/ansible/xoxys.cups) + +Setup cups printserver + +## Table of content + +* [Default Variables](#default-variables) + * [cups_version](#cups_version) + * [cups_packages_extra](#cups_packages_extra) + * [cups_selinux_fcontext](#cups_selinux_fcontext) + * [cups_selinux_restorecon](#cups_selinux_restorecon) + * [cups_admin_group](#cups_admin_group) + * [cups_admin_users](#cups_admin_users) + * [cups_bind_url](#cups_bind_url) + * [cups_server_name](#cups_server_name) + * [cups_server_alias](#cups_server_alias) + * [cups_log_level](#cups_log_level) + * [cups_server_admin](#cups_server_admin) + * [cups_remote_admin_enabled](#cups_remote_admin_enabled) + * [cups_system_groups](#cups_system_groups) + * [cups_iptables_enabled](#cups_iptables_enabled) + * [cups_open_ports](#cups_open_ports) +* [Dependencies](#dependencies) +* [License](#license) +* [Author](#author) + +--- + +## Default Variables + +### cups_version + +#### Default value + +```YAML +cups_version: 2.2.10 +``` + +### cups_packages_extra + +#### Default value + +```YAML +cups_packages_extra: [] +``` + +### cups_selinux_fcontext + +#### Default value + +```YAML +cups_selinux_fcontext: [] +``` + +### cups_selinux_restorecon + +#### Default value + +```YAML +cups_selinux_restorecon: [] +``` + +### cups_admin_group + +#### Default value + +```YAML +cups_admin_group: printadmin +``` + +### cups_admin_users + +#### Default value + +```YAML +cups_admin_users: + - name: cupsadm + password: secure +``` + +### cups_bind_url + +#### Default value + +```YAML +cups_bind_url: + - localhost:631 +``` + +### cups_server_name + +#### Default value + +```YAML +cups_server_name: print.example.org +``` + +### cups_server_alias + +#### Default value + +```YAML +cups_server_alias: '{{ cups_server_name }}' +``` + +### cups_log_level + +#### Default value + +```YAML +cups_log_level: warn +``` + +### cups_server_admin + +#### Default value + +```YAML +cups_server_admin: admin@example.com +``` + +### cups_remote_admin_enabled + +#### Default value + +```YAML +cups_remote_admin_enabled: false +``` + +### cups_system_groups + +#### Default value + +```YAML +cups_system_groups: + - root + - '{{ cups_admin_group }}' +``` + +### cups_iptables_enabled + +#### Default value + +```YAML +cups_iptables_enabled: false +``` + +### cups_open_ports + +#### Default value + +```YAML +cups_open_ports: + - name: allow_cups_ipp + rules: "-A INPUT -m state --state NEW -p tcp --dport 631 -j ACCEPT\n-A OUTPUT\ + \ -m state --state NEW -p tcp --dport 631 -j ACCEPT\n" + state: present + - name: allow_cups_dnssd + rules: "-A OUTPUT -m state --state NEW -p tcp --dport 5353 -j ACCEPT\n-A OUTPUT\ + \ -m state --state NEW -p udp --dport 5353 -j ACCEPT\n" + state: present +``` + +## Dependencies + +None. + +## License + +Robert Kaussow + +## Author + +Robert Kaussow