diff options
Diffstat (limited to 'docs/man/man1/ansible-doc.1')
-rw-r--r-- | docs/man/man1/ansible-doc.1 | 188 |
1 files changed, 188 insertions, 0 deletions
diff --git a/docs/man/man1/ansible-doc.1 b/docs/man/man1/ansible-doc.1 new file mode 100644 index 0000000..434e92c --- /dev/null +++ b/docs/man/man1/ansible-doc.1 @@ -0,0 +1,188 @@ +.\" Man page generated from reStructuredText. +. +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.TH "ANSIBLE-DOC" 1 "" "Ansible 2.14.3" "System administration commands" +.SH NAME +ansible-doc \- plugin documentation tool +.SH SYNOPSIS +.INDENT 0.0 +.TP +.B usage: ansible\-doc [\-h] [\-\-version] [\-v] [\-M MODULE_PATH] +[\-\-playbook\-dir BASEDIR] +[\-t {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,vars,module,strategy,test,filter,role,keyword}] +[\-j] [\-r ROLES_PATH] +[\-e ENTRY_POINT | \-s | \-F | \-l | \-\-metadata\-dump] +[\-\-no\-fail\-on\-errors] +[plugin ...] +.UNINDENT +.SH DESCRIPTION +.sp +displays information on modules installed in Ansible libraries. +It displays a terse listing of plugins and their short descriptions, +provides a printout of their DOCUMENTATION strings, +and it can create a short \(dqsnippet\(dq which can be pasted into a playbook. +.SH COMMON OPTIONS +.INDENT 0.0 +.INDENT 3.5 +Plugin +.UNINDENT +.UNINDENT +.sp +\fB\-\-metadata\-dump\fP +.INDENT 0.0 +.INDENT 3.5 +\fBFor internal use only\fP Dump json metadata for all entries, ignores other options. +.UNINDENT +.UNINDENT +.sp +\fB\-\-no\-fail\-on\-errors\fP +.INDENT 0.0 +.INDENT 3.5 +\fBFor internal use only\fP Only used for \-\-metadata\-dump. Do not fail on errors. Report the error message in the JSON instead. +.UNINDENT +.UNINDENT +.sp +\fB\-\-playbook\-dir\fP \(aqBASEDIR\(aq +.INDENT 0.0 +.INDENT 3.5 +Since this tool does not use playbooks, use this as a substitute playbook directory. This sets the relative path for many features including roles/ group_vars/ etc. +.UNINDENT +.UNINDENT +.sp +\fB\-\-version\fP +.INDENT 0.0 +.INDENT 3.5 +show program\(aqs version number, config file location, configured module search path, module location, executable location and exit +.UNINDENT +.UNINDENT +.sp +\fB\-F\fP, \fB\-\-list_files\fP +.INDENT 0.0 +.INDENT 3.5 +Show plugin names and their source files without summaries (implies \-\-list). A supplied argument will be used for filtering, can be a namespace or full collection name. +.UNINDENT +.UNINDENT +.sp +\fB\-M\fP, \fB\-\-module\-path\fP +.INDENT 0.0 +.INDENT 3.5 +prepend colon\-separated path(s) to module library (default={{ ANSIBLE_HOME ~ \(dq/plugins/modules:/usr/share/ansible/plugins/modules\(dq }}) +.UNINDENT +.UNINDENT +.sp +\fB\-e\fP \(aqENTRY_POINT\(aq, \fB\-\-entry\-point\fP \(aqENTRY_POINT\(aq +.INDENT 0.0 +.INDENT 3.5 +Select the entry point for role(s). +.UNINDENT +.UNINDENT +.sp +\fB\-h\fP, \fB\-\-help\fP +.INDENT 0.0 +.INDENT 3.5 +show this help message and exit +.UNINDENT +.UNINDENT +.sp +\fB\-j\fP, \fB\-\-json\fP +.INDENT 0.0 +.INDENT 3.5 +Change output into json format. +.UNINDENT +.UNINDENT +.sp +\fB\-l\fP, \fB\-\-list\fP +.INDENT 0.0 +.INDENT 3.5 +List available plugins. A supplied argument will be used for filtering, can be a namespace or full collection name. +.UNINDENT +.UNINDENT +.sp +\fB\-r\fP, \fB\-\-roles\-path\fP +.INDENT 0.0 +.INDENT 3.5 +The path to the directory containing your roles. +.UNINDENT +.UNINDENT +.sp +\fB\-s\fP, \fB\-\-snippet\fP +.INDENT 0.0 +.INDENT 3.5 +Show playbook snippet for these plugin types: inventory, lookup, module +.UNINDENT +.UNINDENT +.sp +\fB\-t\fP \(aqTYPE\(aq, \fB\-\-type\fP \(aqTYPE\(aq +.INDENT 0.0 +.INDENT 3.5 +Choose which plugin type (defaults to \(dqmodule\(dq). Available plugin types are : (\(aqbecome\(aq, \(aqcache\(aq, \(aqcallback\(aq, \(aqcliconf\(aq, \(aqconnection\(aq, \(aqhttpapi\(aq, \(aqinventory\(aq, \(aqlookup\(aq, \(aqnetconf\(aq, \(aqshell\(aq, \(aqvars\(aq, \(aqmodule\(aq, \(aqstrategy\(aq, \(aqtest\(aq, \(aqfilter\(aq, \(aqrole\(aq, \(aqkeyword\(aq) +.UNINDENT +.UNINDENT +.sp +\fB\-v\fP, \fB\-\-verbose\fP +.INDENT 0.0 +.INDENT 3.5 +Causes Ansible to print more debug messages. Adding multiple \-v will increase the verbosity, the builtin plugins currently evaluate up to \-vvvvvv. A reasonable level to start is \-vvv, connection debugging might require \-vvvv. +.UNINDENT +.UNINDENT +.SH ENVIRONMENT +.sp +The following environment variables may be specified. +.sp +ANSIBLE_CONFIG \-\- Specify override location for the ansible config file +.sp +Many more are available for most options in ansible.cfg +.sp +For a full list check \fI\%https://docs.ansible.com/\fP\&. or use the \fIansible\-config\fP command. +.SH FILES +.sp +/etc/ansible/ansible.cfg \-\- Config file, used if present +.sp +~/.ansible.cfg \-\- User config file, overrides the default config if present +.sp +\&./ansible.cfg \-\- Local config file (in current working directory) assumed to be \(aqproject specific\(aq and overrides the rest if present. +.sp +As mentioned above, the ANSIBLE_CONFIG environment variable will override all others. +.SH AUTHOR +.sp +Ansible was originally written by Michael DeHaan. +.SH COPYRIGHT +.sp +Copyright © 2018 Red Hat, Inc | Ansible. +Ansible is released under the terms of the GPLv3 license. +.SH SEE ALSO +.sp +\fBansible\fP (1), \fBansible\-config\fP (1), \fBansible\-console\fP (1), \fBansible\-galaxy\fP (1), \fBansible\-inventory\fP (1), \fBansible\-playbook\fP (1), \fBansible\-pull\fP (1), \fBansible\-vault\fP (1) +.sp +Extensive documentation is available in the documentation site: +<\fI\%https://docs.ansible.com\fP>. +IRC and mailing list info can be found in file CONTRIBUTING.md, +available in: <\fI\%https://github.com/ansible/ansible\fP> +.\" Generated by docutils manpage writer. +. |