ansible-doc(1)

1ANSIBLE-DOC(1)          System administration commands          ANSIBLE-DOC(1)
2
3
4

NAME

6       ansible-doc - plugin documentation tool
7

SYNOPSIS

9       usage: ansible-doc [-h] [--version] [-v] [-M MODULE_PATH]
10              [--playbook-dir BASEDIR] [-t {become,cache,callback,cliconf,con‐
11              nection,httpapi,inventory,lookup,netconf,shell,vars,mod‐
12              ule,strategy,test,filter,role,keyword}] [-j] [-r ROLES_PATH] [-e
13              ENTRY_POINT | -s | -F | -l | --metadata-dump]  [--no-fail-on-er‐
14              rors] [plugin ...]
15

DESCRIPTION

17       displays  information  on  modules  installed in Ansible libraries.  It
18       displays a terse listing of plugins and their short descriptions,  pro‐
19       vides  a  printout  of their DOCUMENTATION strings, and it can create a
20       short "snippet" which can be pasted into a playbook.
21

COMMON OPTIONS

23          Plugin
24
25       --metadata-dump
26          For internal use only Dump json metadata for  all  entries,  ignores
27          other options.
28
29       --no-fail-on-errors
30          For  internal use only Only used for --metadata-dump. Do not fail on
31          errors. Report the error message in the JSON instead.
32
33       --playbook-dir 'BASEDIR'
34          Since this tool does not use playbooks, use  this  as  a  substitute
35          playbook  directory.  This  sets the relative path for many features
36          including roles/ group_vars/ etc.
37
38       --version
39          show program's version number, config file location, configured mod‐
40          ule search path, module location, executable location and exit
41
42       -F, --list_files
43          Show  plugin names and their source files without summaries (implies
44          --list). A supplied argument will be used for filtering,  can  be  a
45          namespace or full collection name.
46
47       -M, --module-path
48          prepend  colon-separated path(s) to module library (default={{ ANSI‐
49          BLE_HOME ~ "/plugins/modules:/usr/share/ansible/plugins/modules" }})
50
51       -e 'ENTRY_POINT', --entry-point 'ENTRY_POINT'
52          Select the entry point for role(s).
53
54       -h, --help
55          show this help message and exit
56
57       -j, --json
58          Change output into json format.
59
60       -l, --list
61          List available plugins. A supplied argument will be used for filter‐
62          ing, can be a namespace or full collection name.
63
64       -r, --roles-path
65          The path to the directory containing your roles.
66
67       -s, --snippet
68          Show  playbook  snippet  for  these plugin types: inventory, lookup,
69          module
70
71       -t 'TYPE', --type 'TYPE'
72          Choose which plugin type (defaults to  "module").  Available  plugin
73          types are : ('become', 'cache', 'callback', 'cliconf', 'connection',
74          'httpapi', 'inventory', 'lookup', 'netconf', 'shell', 'vars',  'mod‐
75          ule', 'strategy', 'test', 'filter', 'role', 'keyword')
76
77       -v, --verbose
78          Causes Ansible to print more debug messages. Adding multiple -v will
79          increase the verbosity, the builtin plugins currently evaluate up to
80          -vvvvvv.  A  reasonable level to start is -vvv, connection debugging
81          might require -vvvv.
82

ENVIRONMENT

84       The following environment variables may be specified.
85
86       ANSIBLE_CONFIG -- Specify override location for the ansible config file
87
88       Many more are available for most options in ansible.cfg
89
90       For a full list  check  https://docs.ansible.com/.  or  use  the  ansi‐
91       ble-config command.
92

FILES

94       /etc/ansible/ansible.cfg -- Config file, used if present
95
96       ~/.ansible.cfg  --  User  config  file, overrides the default config if
97       present
98
99       ./ansible.cfg -- Local config file (in current working  directory)  as‐
100       sumed to be 'project specific' and overrides the rest if present.
101
102       As  mentioned above, the ANSIBLE_CONFIG environment variable will over‐
103       ride all others.
104

AUTHOR

106       Ansible was originally written by Michael DeHaan.
107

COPYRIGHT

109       Copyright © 2018 Red Hat, Inc | Ansible.  Ansible is released under the
110       terms of the GPLv3 license.
111