summaryrefslogtreecommitdiffstats
path: root/debian/ansible-lint.1
diff options
context:
space:
mode:
Diffstat (limited to 'debian/ansible-lint.1')
-rw-r--r--debian/ansible-lint.1139
1 files changed, 139 insertions, 0 deletions
diff --git a/debian/ansible-lint.1 b/debian/ansible-lint.1
new file mode 100644
index 0000000..03f1775
--- /dev/null
+++ b/debian/ansible-lint.1
@@ -0,0 +1,139 @@
+.TH ANSIBLE-LINT "1" "June 2023" "ansible-lint" "User Commands"
+.SH NAME
+ansible-lint \- lint tool for Ansible playbooks
+.SH DESCRIPTION
+usage: ansible\-lint [\-h] [\-P | \fB\-L\fR | \fB\-T]\fR
+.TP
+[\-f {brief,full,md,json,codeclimate,quiet,pep8,sarif}]
+[\-\-sarif\-file SARIF_FILE] [\-q]
+[\-\-profile {min,basic,moderate,safety,shared,production}]
+[\-p] [\-\-project\-dir PROJECT_DIR] [\-r RULESDIR] [\-R] [\-s]
+[\-\-write [WRITE_LIST]] [\-\-show\-relpath] [\-t TAGS] [\-v]
+[\-x SKIP_LIST] [\-\-generate\-ignore] [\-w WARN_LIST]
+[\-\-enable\-list ENABLE_LIST] [\-\-nocolor] [\-\-force\-color]
+[\-\-exclude EXCLUDE_PATHS [EXCLUDE_PATHS ...]]
+[\-c CONFIG_FILE] [\-i IGNORE_FILE] [\-\-offline] [\-\-version]
+[lintables ...]
+.SS "positional arguments:"
+.TP
+lintables
+One or more files or paths. When missing it will
+enable auto\-detection mode.
+.SS "options:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit
+.TP
+\fB\-P\fR, \fB\-\-list\-profiles\fR
+List all profiles, no formatting options available.
+.TP
+\fB\-L\fR, \fB\-\-list\-rules\fR
+List all the rules. For listing rules only the
+following formats for argument \fB\-f\fR are supported:
+{brief, full, md} with 'brief' as default.
+.TP
+\fB\-T\fR, \fB\-\-list\-tags\fR
+List all the tags and the rules they cover. Increase
+the verbosity level with `\-v` to include 'opt\-in' tag
+and its rules.
+.TP
+\fB\-f\fR {brief,full,md,json,codeclimate,quiet,pep8,sarif}, \fB\-\-format\fR {brief,full,md,json,codeclimate,quiet,pep8,sarif}
+stdout formatting, json being an alias for
+codeclimate. (default: None)
+.TP
+\fB\-\-sarif\-file\fR SARIF_FILE
+SARIF output file
+.TP
+\fB\-q\fR
+quieter, reduce verbosity, can be specified twice.
+.TP
+\fB\-\-profile\fR {min,basic,moderate,safety,shared,production}
+Specify which rules profile to be used.
+.TP
+\fB\-p\fR, \fB\-\-parseable\fR
+parseable output, same as '\-f pep8'
+.TP
+\fB\-\-project\-dir\fR PROJECT_DIR
+Location of project/repository, autodetected based on
+location of configuration file.
+.TP
+\fB\-r\fR RULESDIR, \fB\-\-rules\-dir\fR RULESDIR
+Specify custom rule directories. Add \fB\-R\fR to keep using
+embedded rules from \fI\,/usr/lib/python3/dist-packages/ansiblelint/rules\/\fP
+.TP
+\fB\-R\fR
+Keep default rules when using \fB\-r\fR
+.TP
+\fB\-s\fR, \fB\-\-strict\fR
+Return non\-zero exit code on warnings as well as
+errors
+.TP
+\fB\-\-write\fR [WRITE_LIST]
+Allow ansible\-lint to reformat YAML files and run rule
+transforms (Reformatting YAML files standardizes
+spacing, quotes, etc. A rule transform can fix or
+simplify fixing issues identified by that rule). You
+can limit the effective rule transforms (the
+\&'write_list') by passing a keywords 'all' or 'none' or
+a comma separated list of rule ids or rule tags. YAML
+reformatting happens whenever '\-\-write' or '\-\-write='
+is used. '\-\-write' and '\-\-write=all' are equivalent:
+they allow all transforms to run. The effective list
+of transforms comes from 'write_list' in the config
+file, followed whatever '\-\-write' args are provided on
+the commandline. '\-\-write=none' resets the list of
+transforms to allow reformatting YAML without running
+any of the transforms (ie '\-\-write=none,rule\-id' will
+ignore write_list in the config file and only run the
+rule\-id transform).
+.TP
+\fB\-\-show\-relpath\fR
+Display path relative to CWD
+.TP
+\fB\-t\fR TAGS, \fB\-\-tags\fR TAGS
+only check rules whose id/tags match these values
+.TP
+\fB\-v\fR
+Increase verbosity level (\fB\-vv\fR for more)
+.TP
+\fB\-x\fR SKIP_LIST, \fB\-\-skip\-list\fR SKIP_LIST
+only check rules whose id/tags do not match these
+values. e.g: \fB\-\-skip\-list\fR=\fI\,name\/\fR,run\-once
+.TP
+\fB\-\-generate\-ignore\fR
+Generate a text file '.ansible\-lint\-ignore' that
+ignores all found violations. Each line contains
+filename and rule id separated by a space.
+.TP
+\fB\-w\fR WARN_LIST, \fB\-\-warn\-list\fR WARN_LIST
+only warn about these rules, unless overridden in
+config file. Current version default value is:
+experimental, jinja[spacing], fqcn[deep]
+.TP
+\fB\-\-enable\-list\fR ENABLE_LIST
+activate optional rules by their tag name
+.TP
+\fB\-\-nocolor\fR
+disable colored output, same as NO_COLOR=1
+.TP
+\fB\-\-force\-color\fR
+Force colored output, same as FORCE_COLOR=1
+.TP
+\fB\-\-exclude\fR EXCLUDE_PATHS [EXCLUDE_PATHS ...]
+path to directories or files to skip. This option is
+repeatable.
+.TP
+\fB\-c\fR CONFIG_FILE, \fB\-\-config\-file\fR CONFIG_FILE
+Specify configuration file to use. By default it will
+look for '.ansible\-lint', '.config/ansible\-lint.yml',
+or '.config/ansible\-lint.yaml'
+.TP
+\fB\-i\fR IGNORE_FILE, \fB\-\-ignore\-file\fR IGNORE_FILE
+Specify ignore file to use. By default it will look
+for '.ansible\-lint\-ignore' or '.config/ansible\-lintignore.txt'
+.TP
+\fB\-\-offline\fR
+Disable installation of requirements.yml and schema
+refreshing
+.HP
+\fB\-\-version\fR