@@ -19,6 +19,12 @@ rpm-build

 # Mac OS X stuff...

 .DS_Store

 # manpage build stuff...

+docs/man/man1/ansible.1

+docs/man/man1/ansible-doc.1

+docs/man/man1/ansible-galaxy.1

+docs/man/man1/ansible-playbook.1

+docs/man/man1/ansible-pull.1

+docs/man/man1/ansible-vault.1

 docs/man/man3/*

 # Sublime stuff

 *.sublime-project

deleted file mode 100644

@@ -1,66 +0,0 @@

-'\" t

-.\"     Title: ansible-doc

-.\"    Author: :doctype:manpage

-.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>

-.\"      Date: 12/09/2014

-.\"    Manual: System administration commands

-.\"    Source: Ansible 1.9

-.\"  Language: English

-.\"

-.TH "ANSIBLE\-DOC" "1" "12/09/2014" "Ansible 1\&.9" "System administration commands"

-.\" -----------------------------------------------------------------

-.\" * Define some portability stuff

-.\" -----------------------------------------------------------------

-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-.\" http://bugs.debian.org/507673

-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-.ie \n(.g .ds Aq \(aq

-.el       .ds Aq '

-.\" -----------------------------------------------------------------

-.\" * set default formatting

-.\" -----------------------------------------------------------------

-.\" disable hyphenation

-.nh

-.\" disable justification (adjust text to left margin only)

-.ad l

-.\" -----------------------------------------------------------------

-.\" * MAIN CONTENT STARTS HERE *

-.\" -----------------------------------------------------------------

-.SH "NAME"

-ansible-doc \- show documentation on Ansible modules

-.SH "SYNOPSIS"

-.sp

-ansible\-doc [\-M module_path] [\-l] [\-s] [module\&...]

-.SH "DESCRIPTION"

-.sp

-\fBansible\-doc\fR displays information on modules installed in Ansible libraries\&. It displays a terse listing of modules and their short descriptions, provides a printout of their DOCUMENTATION strings, and it can create a short "snippet" which can be pasted into a playbook\&.

-.SH "OPTIONS"

-.PP

-\fB\-M\fR \fIdirectory\fR, \fB\-\-module\-path=\fR\fIdirectory\fR

-.RS 4

-Add an additional directory to the default path for finding module libraries\&.

-.RE

-.PP

-\fB\-s\fR, \fB\-\-snippet=\fR

-.RS 4

-Produce a snippet which can be copied into a playbook for modification, like a kind of task template\&.

-.RE

-.PP

-\fB\-l\fR, \fB\-\-list=\fR

-.RS 4

-Produce a terse listing of modules and a short description of each\&.

-.RE

-.SH "AUTHOR"

-.sp

-ansible\-doc was originally written by Jan\-Piet Mens\&. See the AUTHORS file for a complete list of contributors\&.

-.SH "COPYRIGHT"

-.sp

-Copyright \(co 2012, Jan\-Piet Mens

-.sp

-Ansible is released under the terms of the GPLv3 License\&.

-.SH "SEE ALSO"

-.sp

-\fBansible\-playbook\fR(1), \fBansible\fR(1), \fBansible\-pull\fR(1)

-.sp

-Extensive documentation is available in the documentation site: http://docs\&.ansible\&.com\&. IRC and mailing list info can be found in file CONTRIBUTING\&.md, available in: https://github\&.com/ansible/ansible

@@ -28,9 +28,11 @@ playbook.

 OPTIONS

 -------

-*-M* 'directory', *--module-path=*'directory'::

+*-M* 'DIRECTORY', *--module-path=*'DIRECTORY'::

-Add an additional directory to the default path for finding module libraries.

+the 'DIRECTORY' search path to load modules from. The default is

+'/usr/share/ansible'. This can also be set with the ANSIBLE_LIBRARY

+environment variable.

 *-s*, *--snippet=*::

@@ -41,6 +43,24 @@ a kind of task template.

 Produce a terse listing of modules and a short description of each.

+

+ENVIRONMENT

+-----------

+

+ANSIBLE_LIBRARY -- Override the default ansible module library path

+

+

+FILES

+-----

+

+/usr/share/ansible/ -- Default module library

+

+/etc/ansible/ansible.cfg -- Config file, used if present

+

+~/.ansible.cfg -- User config file, overrides the default config if present

+

+

+

 AUTHOR

 ------

@@ -59,7 +79,7 @@ Ansible is released under the terms of the GPLv3 License.

 SEE ALSO

 --------

-*ansible-playbook*(1), *ansible*(1), *ansible-pull*(1)

+*ansible-playbook*(1), *ansible*(1), *ansible-pull*(1), *ansible-vault*(1), *ansible-galaxy*(1)

 Extensive documentation is available in the documentation site:

 <http://docs.ansible.com>. IRC and mailing list info can be found

deleted file mode 100644

@@ -1,185 +0,0 @@

-'\" t

-.\"     Title: ansible-galaxy

-.\"    Author: [see the "AUTHOR" section]

-.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>

-.\"      Date: 05/05/2015

-.\"    Manual: System administration commands

-.\"    Source: Ansible 2.0.0

-.\"  Language: English

-.\"

-.TH "ANSIBLE\-GALAXY" "1" "05/05/2015" "Ansible 2\&.0\&.0" "System administration commands"

-.\" -----------------------------------------------------------------

-.\" * Define some portability stuff

-.\" -----------------------------------------------------------------

-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-.\" http://bugs.debian.org/507673

-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-.ie \n(.g .ds Aq \(aq

-.el       .ds Aq '

-.\" -----------------------------------------------------------------

-.\" * set default formatting

-.\" -----------------------------------------------------------------

-.\" disable hyphenation

-.nh

-.\" disable justification (adjust text to left margin only)

-.ad l

-.\" -----------------------------------------------------------------

-.\" * MAIN CONTENT STARTS HERE *

-.\" -----------------------------------------------------------------

-.SH "NAME"

-ansible-galaxy \- manage roles using galaxy\&.ansible\&.com

-.SH "SYNOPSIS"

-.sp

-ansible\-galaxy [init|info|install|list|remove] [\-\-help] [options] \&...

-.SH "DESCRIPTION"

-.sp

-\fBAnsible Galaxy\fR is a shared repository for Ansible roles (added in ansible version 1\&.2)\&. The ansible\-galaxy command can be used to manage these roles, or by creating a skeleton framework for roles you\(cqd like to upload to Galaxy\&.

-.SH "COMMON OPTIONS"

-.PP

-\fB\-h\fR, \fB\-\-help\fR

-.RS 4

-Show a help message related to the given sub\-command\&.

-.RE

-.SH "INSTALL"

-.sp

-The \fBinstall\fR sub\-command is used to install roles\&.

-.SS "USAGE"

-.sp

-$ ansible\-galaxy install [options] [\-r FILE | role_name(s)[,version] | tar_file(s)]

-.sp

-Roles can be installed in several different ways:

-.sp

-.RS 4

-.ie n \{\

-\h'-04'\(bu\h'+03'\c

-.\}

-.el \{\

-.sp -1

-.IP \(bu 2.3

-.\}

-A username\&.rolename[,version] \- this will install a single role\&. The Galaxy API will be contacted to provide the information about the role, and the corresponding \&.tar\&.gz will be downloaded from

-\fBgithub\&.com\fR\&. If the version is omitted, the most recent version available will be installed\&.

-.RE

-.sp

-.RS 4

-.ie n \{\

-\h'-04'\(bu\h'+03'\c

-.\}

-.el \{\

-.sp -1

-.IP \(bu 2.3

-.\}

-A file name, using

-\fB\-r\fR

-\- this will install multiple roles listed one per line\&. The format of each line is the same as above: username\&.rolename[,version]

-.RE

-.sp

-.RS 4

-.ie n \{\

-\h'-04'\(bu\h'+03'\c

-.\}

-.el \{\

-.sp -1

-.IP \(bu 2.3

-.\}

-A \&.tar\&.gz of a valid role you\(cqve downloaded directly from

-\fBgithub\&.com\fR\&. This is mainly useful when the system running Ansible does not have access to the Galaxy API, for instance when behind a firewall or proxy\&.

-.RE

-.SS "OPTIONS"

-.PP

-\fB\-f\fR, \fB\-\-force\fR

-.RS 4

-Force overwriting an existing role\&.

-.RE

-.PP

-\fB\-i\fR, \fB\-\-ignore\-errors\fR

-.RS 4

-Ignore errors and continue with the next specified role\&.

-.RE

-.PP

-\fB\-n\fR, \fB\-\-no\-deps\fR

-.RS 4

-Don\(cqt download roles listed as dependencies\&.

-.RE

-.PP

-\fB\-p\fR \fIROLES_PATH\fR, \fB\-\-roles\-path=\fR\fIROLES_PATH\fR

-.RS 4

-The path to the directory containing your roles\&. The default is the

-\fBroles_path\fR

-configured in your

-\fBansible\&.cfg\fR

-file (/etc/ansible/roles if not configured)

-.RE

-.PP

-\fB\-r\fR \fIROLE_FILE\fR, \fB\-\-role\-file=\fR\fIROLE_FILE\fR

-.RS 4

-A file containing a list of roles to be imported, as specified above\&. This option cannot be used if a rolename or \&.tar\&.gz have been specified\&.

-.RE

-.SH "REMOVE"

-.sp

-The \fBremove\fR sub\-command is used to remove one or more roles\&.

-.SS "USAGE"

-.sp

-$ ansible\-galaxy remove role1 role2 \&...

-.SS "OPTIONS"

-.PP

-\fB\-p\fR \fIROLES_PATH\fR, \fB\-\-roles\-path=\fR\fIROLES_PATH\fR

-.RS 4

-The path to the directory containing your roles\&. The default is the

-\fBroles_path\fR

-configured in your

-\fBansible\&.cfg\fR

-file (/etc/ansible/roles if not configured)

-.RE

-.SH "INIT"

-.sp

-The \fBinit\fR command is used to create an empty role suitable for uploading to https://galaxy\&.ansible\&.com (or for roles in general)\&.

-.SS "USAGE"

-.sp

-$ ansible\-galaxy init [options] role_name

-.SS "OPTIONS"

-.PP

-\fB\-f\fR, \fB\-\-force\fR

-.RS 4

-Force overwriting an existing role\&.

-.RE

-.PP

-\fB\-p\fR \fIINIT_PATH\fR, \fB\-\-init\-path=\fR\fIINIT_PATH\fR

-.RS 4

-The path in which the skeleton role will be created\&.The default is the current working directory\&.

-.RE

-.PP

-\fB\-\-offline\fR

-.RS 4

-Don\(cqt query the galaxy API when creating roles

-.RE

-.SH "LIST"

-.sp

-The \fBlist\fR sub\-command is used to show what roles are currently instaled\&. You can specify a role name, and if installed only that role will be shown\&.

-.SS "USAGE"

-.sp

-$ ansible\-galaxy list [role_name]

-.SS "OPTIONS"

-.PP

-\fB\-p\fR \fIROLES_PATH\fR, \fB\-\-roles\-path=\fR\fIROLES_PATH\fR

-.RS 4

-The path to the directory containing your roles\&. The default is the

-\fBroles_path\fR

-configured in your

-\fBansible\&.cfg\fR

-file (/etc/ansible/roles if not configured)

-.RE

-.SH "AUTHOR"

-.sp

-Ansible was originally written by Michael DeHaan\&. See the AUTHORS file for a complete list of contributors\&.

-.SH "COPYRIGHT"

-.sp

-Copyright \(co 2014, Michael DeHaan

-.sp

-Ansible is released under the terms of the GPLv3 License\&.

-.SH "SEE ALSO"

-.sp

-\fBansible\fR(1), \fBansible\-pull\fR(1), \fBansible\-doc\fR(1)

-.sp

-Extensive documentation is available in the documentation site: http://docs\&.ansible\&.com\&. IRC and mailing list info can be found in file CONTRIBUTING\&.md, available in: https://github\&.com/ansible/ansible

@@ -18,10 +18,9 @@ ansible-galaxy [init|info|install|list|remove] [--help] [options] ...

 DESCRIPTION

 -----------

-*Ansible Galaxy* is a shared repository for Ansible roles (added in

-ansible version 1.2). The ansible-galaxy command can be used to manage

-these roles, or by creating a skeleton framework for roles you'd like

-to upload to Galaxy.

+*Ansible Galaxy* is a shared repository for Ansible roles.

+The ansible-galaxy command can be used to manage these roles,

+or by creating a skeleton framework for roles you'd like to upload to Galaxy.

 COMMON OPTIONS

 --------------

@@ -43,16 +42,16 @@ $ ansible-galaxy install [options] [-r FILE | role_name(s)[,version] | tar_file(

 Roles can be installed in several different ways:

-* A username.rolename[,version] - this will install a single role. The Galaxy 

-  API will be contacted to provide the information about the role, and the 

-  corresponding .tar.gz will be downloaded from *github.com*. If the version 

+* A username.rolename[,version] - this will install a single role. The Galaxy

+  API will be contacted to provide the information about the role, and the

+  corresponding .tar.gz will be downloaded from *github.com*. If the version

   is omitted, the most recent version available will be installed.

 * A file name, using *-r* - this will install multiple roles listed one per

   line. The format of each line is the same as above: username.rolename[,version]

 * A .tar.gz of a valid role you've downloaded directly from *github.com*. This

-  is mainly useful when the system running Ansible does not have access to 

+  is mainly useful when the system running Ansible does not have access to

   the Galaxy API, for instance when behind a firewall or proxy.

@@ -164,7 +163,7 @@ Ansible is released under the terms of the GPLv3 License.

 SEE ALSO

 --------

-*ansible*(1), *ansible-pull*(1), *ansible-doc*(1)

+*ansible*(1), *ansible-pull*(1), *ansible-doc*(1), *ansible-playbook*(1), *ansible-vault*(1)

 Extensive documentation is available in the documentation site:

 <http://docs.ansible.com>. IRC and mailing list info can be found

deleted file mode 100644

@@ -1,269 +0,0 @@

-'\" t

-.\"     Title: ansible-playbook

-.\"    Author: :doctype:manpage

-.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>

-.\"      Date: 07/23/2015

-.\"    Manual: System administration commands

-.\"    Source: Ansible %VERSION%

-.\"  Language: English

-.\"

-.TH "ANSIBLE\-PLAYBOOK" "1" "07/23/2015" "Ansible %VERSION%" "System administration commands"

-.\" -----------------------------------------------------------------

-.\" * Define some portability stuff

-.\" -----------------------------------------------------------------

-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-.\" http://bugs.debian.org/507673

-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-.ie \n(.g .ds Aq \(aq

-.el       .ds Aq '

-.\" -----------------------------------------------------------------

-.\" * set default formatting

-.\" -----------------------------------------------------------------

-.\" disable hyphenation

-.nh

-.\" disable justification (adjust text to left margin only)

-.ad l

-.\" -----------------------------------------------------------------

-.\" * MAIN CONTENT STARTS HERE *

-.\" -----------------------------------------------------------------

-.SH "NAME"

-ansible-playbook \- run an ansible playbook

-.SH "SYNOPSIS"

-.sp

-ansible\-playbook <filename\&.yml> \&... [options]

-.SH "DESCRIPTION"

-.sp

-\fBAnsible playbooks\fR are a configuration and multinode deployment system\&. Ansible\-playbook is the tool used to run them\&. See the project home page (link below) for more information\&.

-.SH "ARGUMENTS"

-.PP

-\fBfilename\&.yml\fR

-.RS 4

-The names of one or more YAML format files to run as ansible playbooks\&.

-.RE

-.SH "OPTIONS"

-.PP

-\fB\-k\fR, \fB\-\-ask\-pass\fR

-.RS 4

-Prompt for the SSH password instead of assuming key\-based authentication with ssh\-agent\&.

-.RE

-.PP

-\fB\-K\fR, \fB\-\-ask\-sudo\-pass\fR

-.RS 4

-Prompt for the password to use for playbook plays that request sudo access, if any\&.

-.RE

-.PP

-\fB\-b\fR, \fB\-\-become\fR

-.RS 4

-Run operations with become (nopasswd implied)

-.RE

-.PP

-\fB\-\-become\-method=BECOME_METHOD\fR

-.RS 4

-Privilege escalation method to use (default=sudo), valid choices: [ sudo | su | pbrun | pfexec | runas | doas ]

-.RE

-.PP

-\fB\-\-become\-user=BECOME_USER\fR

-.RS 4

-Run operations as this user (default=None)\&.

-.RE

-.PP

-\fB\-C\fR, \fB\-\-check\fR

-.RS 4

-Do not make any changes on the remote system, but test resources to see what might have changed\&. Note this can not scan all possible resource types and is only a simulation\&.

-.RE

-.PP

-\fB\-c\fR \fICONNECTION\fR, \fB\-\-connection=\fR\fICONNECTION\fR

-.RS 4

-Connection type to use\&. Possible options are

-\fIparamiko\fR

-(SSH),

-\fIssh\fR, and

-\fIlocal\fR\&.

-\fIlocal\fR

-is mostly useful for crontab or kickstarts\&.

-.RE

-.PP

-\fB\-D\fR, \fB\-\-diff\fR

-.RS 4

-When changing any templated files, show the unified diffs of how they changed\&. When used with \-\-check, shows how the files would have changed if \-\-check were not used\&.

-.RE

-.PP

-\fB\-e\fR \fIVARS\fR, \fB\-\-extra\-vars=\fR\fIVARS\fR

-.RS 4

-Extra variables to inject into a playbook, in key=value key=value format or as quoted JSON (hashes and arrays)\&. To load variables from a file, specify the file preceded by @ (e\&.g\&. @vars\&.yml)\&.

-.RE

-.PP

-\fB\-\-flush\-cache\fR

-.RS 4

-Clear the fact cache\&.

-.RE

-.PP

-\fB\-\-force\-handlers\fR

-.RS 4

-Run handlers even if a task fails\&.

-.RE

-.PP

-\fB\-f\fR \fINUM\fR, \fB\-\-forks=\fR\fINUM\fR

-.RS 4

-Level of parallelism\&.

-\fINUM\fR

-is specified as an integer, the default is 5\&.

-.RE

-.PP

-\fB\-h\fR, \fB\-\-help\fR

-.RS 4

-Show help page and exit

-.RE

-.PP

-\fB\-i\fR \fIPATH\fR, \fB\-\-inventory=\fR\fIPATH\fR

-.RS 4

-The

-\fIPATH\fR

-to the inventory hosts file, which defaults to

-\fI/etc/ansible/hosts\fR\&.

-.RE

-.PP

-\fB\-l\fR \fISUBSET\fR, \fB\-\-limit=\fR\fISUBSET\fR

-.RS 4

-Further limits the selected host/group patterns\&.

-.RE

-.PP

-\fB\-\-list\-hosts\fR

-.RS 4

-Outputs a list of matching hosts; does not execute anything else\&.

-.RE

-.PP

-\fB\-\-list\-tags\fR

-.RS 4

-List all available tags\&.

-.RE

-.PP

-\fB\-\-list\-tasks\fR

-.RS 4

-List all tasks that would be executed

-.RE

-.PP

-\fB\-M\fR \fIDIRECTORY\fR, \fB\-\-module\-path=\fR\fIDIRECTORY\fR

-.RS 4

-The

-\fIDIRECTORY\fR

-search path to load modules from\&. The default is

-\fI/usr/share/ansible\fR\&. This can also be set with the ANSIBLE_LIBRARY environment variable\&.

-.RE

-.PP

-\fB\-\-private\-key=\fR\fIPRIVATE_KEY_FILE\fR

-.RS 4

-Use this file to authenticate the connection

-.RE

-.PP

-\fB\-\-skip\-tages=\fR\fISKIP_TAGS\fR

-.RS 4

-Only run plays and tasks whose tags do not match these values\&.

-.RE

-.PP

-\fB\-\-start\-at\-task=\fR\fISTART_AT\fR

-.RS 4

-Start the playbook at the task matching this name\&.

-.RE

-.PP

-\fB\-\-step\fR

-.RS 4

-One\-step\-at\-a\-time: confirm each task before running\&.

-.RE

-.PP

-\fB\-S\fR, \-\-su*

-.RS 4

-Run operations with su (deprecated, use become)

-.RE

-.PP

-\fB\-R SU\-USER\fR, \fB\-\-su\-user=\fR\fISU_USER\fR

-.RS 4

-run operations with su as this user (default=root) (deprecated, use become)

-.RE

-.PP

-\fB\-s\fR, \fB\-\-sudo\fR

-.RS 4

-Run operations with sudo (nopasswd) (deprecated, use become)

-.RE

-.PP

-\fB\-U\fR, \fISUDO_USER\fR, \fB\-\-sudo\-user=\fR\fISUDO_USER\fR

-.RS 4

-Desired sudo user (default=root) (deprecated, use become)\&.

-.RE

-.PP

-\fB\-\-skip\-tags=\fR\fISKIP_TAGS\fR

-.RS 4

-Only run plays and tasks whose tags do not match these values\&.

-.RE

-.PP

-\fB\-\-syntax\-check\fR

-.RS 4

-Look for syntax errors in the playbook, but don\(cqt run anything

-.RE

-.PP

-\fB\-t\fR, \fITAGS\fR, \fB\-\-tags=\fR\fITAGS\fR

-.RS 4

-Only run plays and tasks tagged with these values\&.

-.RE

-.PP

-\fB\-T\fR \fISECONDS\fR, \fB\-\-timeout=\fR\fISECONDS\fR

-.RS 4

-Connection timeout to use when trying to talk to hosts, in

-\fISECONDS\fR\&.

-.RE

-.PP

-\fB\-u\fR \fIUSERNAME\fR, \fB\-\-user=\fR\fIUSERNAME\fR

-.RS 4

-Use this remote user name on playbook steps that do not indicate a user name to run as\&.

-.RE

-.PP

-\fB\-\-vault\-password\-file=\fR\fIVAULT_PASSWORD_FILE\fR

-.RS 4

-Vault password file\&.

-.RE

-.PP

-\fB\-v\fR, \fB\-\-verbose\fR

-.RS 4

-Verbose mode, more output from successful actions will be shown\&. Give up to three times for more output\&.

-.RE

-.PP

-\fB\-\-version\fR

-.RS 4

-Show program\(cqs version number and exit\&.

-.RE

-.SH "ENVIRONMENT"

-.sp

-The following environment variables may be specified\&.

-.sp

-ANSIBLE_INVENTORY  \(em Override the default ansible inventory file

-.sp

-ANSIBLE_LIBRARY \(em Override the default ansible module library path

-.SH "FILES"

-.sp

-/etc/ansible/hosts \(em Default inventory file

-.sp

-/usr/share/ansible/ \(em Default module library

-.sp

-/etc/ansible/ansible\&.cfg \(em Config file, used if present

-.sp

-~/\&.ansible\&.cfg \(em User config file, overrides the default config if present

-.SH "AUTHOR"

-.sp

-Ansible was originally written by Michael DeHaan\&. See the AUTHORS file for a complete list of contributors\&.

-.SH "COPYRIGHT"

-.sp

-Copyright \(co 2012, Michael DeHaan

-.sp

-Ansible is released under the terms of the GPLv3 License\&.

-.SH "SEE ALSO"

-.sp

-\fBansible\fR(1), \fBansible\-pull\fR(1), \fBansible\-doc\fR(1)

-.sp

-Extensive documentation is available in the documentation site: http://docs\&.ansible\&.com\&. IRC and mailing list info can be found in file CONTRIBUTING\&.md, available in: https://github\&.com/ansible/ansible

-.SH "AUTHOR"

-.PP

-\fB:doctype:manpage\fR

-.RS 4

-Author.

-.RE

@@ -34,28 +34,26 @@ The names of one or more YAML format files to run as ansible playbooks.

 OPTIONS

 -------

-*-k*, *--ask-pass*::

+*--ask-become-pass*::

-Prompt for the SSH password instead of assuming key-based

-authentication with ssh-agent.

+Ask for privilege escalation password.

-*-K*, *--ask-sudo-pass*::

+*-k*, *--ask-pass*::

-Prompt for the password to use for playbook plays that request sudo

-access, if any.

+Prompt for the connection password, if it is needed for the transport used.

+For example, using ssh and not having  a key-based authentication with ssh-agent.

-*-b*, *--become*::

+*--ask-su-pass*::

-Run operations with become (nopasswd implied)

+Prompt for su password, used with --su (deprecated, use become).

-*--become-method=BECOME_METHOD*::

+*-K*, *--ask-sudo-pass*::

-Privilege escalation method to use (default=sudo),

-valid choices: [ sudo | su | pbrun | pfexec | runas | doas ]

+Prompt for the password to use with --sudo, if any (deprecated, use become).

-*--become-user=BECOME_USER*::

+*--ask-vault-pass*::

-Run operations as this user (default=None).

+Prompt for vault password.

 *-C*, *--check*::

@@ -65,7 +63,7 @@ a simulation.

 *-c* 'CONNECTION', *--connection=*'CONNECTION'::

-Connection type to use.  Possible options are 'paramiko' (SSH), 'ssh',

+Connection type to use.  Most common options are 'paramiko' (SSH), 'ssh', 'winrm'

 and 'local'.  'local' is mostly useful for crontab or kickstarts.

 *-D*, *--diff*::

@@ -73,10 +71,10 @@ and 'local'.  'local' is mostly useful for crontab or kickstarts.

 When changing any templated files, show the unified diffs of how they changed.  When

 used with --check, shows how the files would have changed if --check were not used.

-*-e* 'VARS', *--extra-vars=*'VARS'::

+*-e* 'EXTRA_VARS', *--extra-vars=*'EXTRA_VARS'::

 Extra variables to inject into a playbook, in key=value key=value format or

-as quoted JSON (hashes and arrays). To load variables from a file, specify

+as quoted YAML/JSON (hashes and arrays). To load variables from a file, specify

 the file preceded by @ (e.g. @vars.yml).

 *--flush-cache*::

@@ -97,12 +95,13 @@ Show help page and exit

 *-i* 'PATH', *--inventory=*'PATH'::

-The 'PATH' to the inventory hosts file, which defaults to

-'/etc/ansible/hosts'.

+The 'PATH' to the inventory, which defaults to '/etc/ansible/hosts'.

+Alternatively you can use a comma separated list of hosts or single host with traling comma 'host,'.

 *-l* 'SUBSET', *--limit=*'SUBSET'::

 Further limits the selected host/group patterns.

+You can prefix it with '~' to indicate that the patter in a regex.

 *--list-hosts*::

@@ -110,11 +109,11 @@ Outputs a list of matching hosts; does not execute anything else.

 *--list-tags*::

-List all available tags.

+List all available tags; does not execute anything else.

 *--list-tasks*::

-List all tasks that would be executed

+List all tasks that would be executed; does not execute anything else.

 *-M* 'DIRECTORY', *--module-path=*'DIRECTORY'::

@@ -144,12 +143,11 @@ Run operations with su (deprecated, use become)

 *-R SU-USER*, *--su-user=*'SU_USER'::

-run operations with su as this user (default=root)

-(deprecated, use become)

+run operations with su as this user (default=root) (deprecated, use become)

 *-s*, *--sudo*::

-Run operations with sudo (nopasswd) (deprecated, use become)

+Run the command as the user given by -u and sudo to root (deprecated, use become).

 *--ssh-common-args=*''-o ProxyCommand="ssh -W %h:%p ..." ...''::

@@ -169,9 +167,9 @@ Add the specified arguments to any scp command-line.

 Add the specified arguments to any ssh command-line.

-*-U*, 'SUDO_USER', *--sudo-user=*'SUDO_USER'::

+*-U* 'SUDO_USERNAME', *--sudo-user=*'SUDO_USERNAME'::

-Desired sudo user (default=root) (deprecated, use become).

+Sudo to 'SUDO_USERNAME' deafult is root. (deprecated, use become).

 *--skip-tags=*'SKIP_TAGS'::

@@ -191,8 +189,7 @@ Connection timeout to use when trying to talk to hosts, in 'SECONDS'.

 *-u* 'USERNAME', *--user=*'USERNAME'::

-Use this remote user name on playbook steps that do not indicate a

-user name to run as.

+Use this 'USERNAME' to login to the target host, instead of the current user.

 *--vault-password-file=*'VAULT_PASSWORD_FILE'::

@@ -207,6 +204,7 @@ up to three times for more output.

 Show program's version number and exit.

+

 ENVIRONMENT

 -----------

@@ -216,6 +214,11 @@ ANSIBLE_INVENTORY  -- Override the default ansible inventory file

 ANSIBLE_LIBRARY -- Override the default ansible module library path

+ANSIBLE_CONFIG -- Override the default ansible config file

+

+Many more are available for most options in ansible.cfg

+

+

 FILES

 -----

@@ -227,6 +230,7 @@ FILES

 ~/.ansible.cfg -- User config file, overrides the default config if present

+

 AUTHOR

 ------

@@ -245,7 +249,7 @@ Ansible is released under the terms of the GPLv3 License.

 SEE ALSO

 --------

-*ansible*(1), *ansible-pull*(1), *ansible-doc*(1)

+*ansible*(1), *ansible-pull*(1), *ansible-doc*(1), *ansible-vault*(1), *ansible-galaxy*(1)

 Extensive documentation is available in the documentation site:

 <http://docs.ansible.com>. IRC and mailing list info can be found

deleted file mode 100644

@@ -1,159 +0,0 @@

-'\" t

-.\"     Title: ansible

-.\"    Author: :doctype:manpage

-.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>

-.\"      Date: 07/22/2015

-.\"    Manual: System administration commands

-.\"    Source: Ansible %VERSION%

-.\"  Language: English

-.\"

-.TH "ANSIBLE" "1" "07/22/2015" "Ansible %VERSION%" "System administration commands"

-.\" -----------------------------------------------------------------

-.\" * Define some portability stuff

-.\" -----------------------------------------------------------------

-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-.\" http://bugs.debian.org/507673

-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-.ie \n(.g .ds Aq \(aq

-.el       .ds Aq '

-.\" -----------------------------------------------------------------

-.\" * set default formatting

-.\" -----------------------------------------------------------------

-.\" disable hyphenation

-.nh

-.\" disable justification (adjust text to left margin only)

-.ad l

-.\" -----------------------------------------------------------------

-.\" * MAIN CONTENT STARTS HERE *

-.\" -----------------------------------------------------------------

-.SH "NAME"

-ansible-pull \- set up a remote copy of ansible on each managed node

-.SH "SYNOPSIS"

-.sp

-ansible\-pull \-d DEST \-U URL [options] [ <filename\&.yml> ]

-.SH "DESCRIPTION"

-.sp

-\fBAnsible\fR is an extra\-simple tool/framework/API for doing \*(Aqremote things\*(Aq over SSH\&.

-.sp

-Use ansible\-pull to set up a remote copy of ansible on each managed node, each set to run via cron and update playbook source via a source repository\&. This inverts the default \fBpush\fR architecture of ansible into a \fBpull\fR architecture, which has near\-limitless scaling potential\&.

-.sp

-The setup playbook can be tuned to change the cron frequency, logging locations, and parameters to ansible\-pull\&.

-.sp

-This is useful both for extreme scale\-out as well as periodic remediation\&. Usage of the \fIfetch\fR module to retrieve logs from ansible\-pull runs would be an excellent way to gather and analyze remote logs from ansible\-pull\&.

-.SH "OPTIONAL ARGUMENT"

-.PP

-\fBfilename\&.yml\fR

-.RS 4

-The name of one the YAML format files to run as an ansible playbook\&. This can be a relative path within the checkout\&. If not provided, ansible\-pull will look for a playbook based on the host\(cqs fully\-qualified domain name, on the host hostname and finally a playbook named

-\fBlocal\&.yml\fR\&.

-.RE

-.SH "OPTIONS"

-.PP

-\fB\-\-accept\-host\-key\fR

-.RS 4

-Adds the hostkey for the repo URL if not already added\&.

-.RE

-.PP

-\fB\-K\fR, \fB\-\-ask\-sudo\-pass\fR

-.RS 4

-Ask for sudo password\&.

-.RE

-.PP

-\fB\-C\fR \fICHECKOUT\fR, \fB\-\-checkout=\fR\fICHECKOUT\fR

-.RS 4

-Branch/Tag/Commit to checkout\&. If not provided, uses default behavior of module used to check out playbook repository\&.

-.RE

-.PP

-\fB\-d\fR \fIDEST\fR, \fB\-\-directory=\fR\fIDEST\fR

-.RS 4

-Directory to checkout repository into\&. If not provided, a subdirectory of ~/\&.ansible/pull/ will be used\&.

-.RE

-.PP

-\fB\-e\fR \fIEXTRA_VARS\fR, \fB\-\-extra\-vars=\fR\*(AqEXTRA_VARS*

-.RS 4

-Set additional variables as key=value or YAML/JSON

-.RE

-.PP

-\fB\-f\fR, \fB\-\-force\fR