chef 12.0.3 → 12.1.0.rc.0

data/distro/common/man/man1/knife-deps.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-DEPS" "1" "Chef 11.16" "" "knife deps"
+.TH "KNIFE-DEPS" "1" "Chef 12.0" "" "knife deps"
 .SH NAME
 knife-deps \- The man page for the knife deps subcommand.
 .

data/distro/common/man/man1/knife-diff.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-DIFF" "1" "Chef 11.16" "" "knife diff"
+.TH "KNIFE-DIFF" "1" "Chef 12.0" "" "knife diff"
 .SH NAME
 knife-diff \- The man page for the knife diff subcommand.
 .

data/distro/common/man/man1/knife-download.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-DOWNLOAD" "1" "Chef 11.16" "" "knife download"
+.TH "KNIFE-DOWNLOAD" "1" "Chef 12.0" "" "knife download"
 .SH NAME
 knife-download \- The man page for the knife download subcommand.
 .

data/distro/common/man/man1/knife-edit.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-EDIT" "1" "Chef 11.16" "" "knife edit"
+.TH "KNIFE-EDIT" "1" "Chef 12.0" "" "knife edit"
 .SH NAME
 knife-edit \- The man page for the knife edit subcommand.
 .

data/distro/common/man/man1/knife-environment.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-ENVIRONMENT" "1" "Chef 11.16" "" "knife environment"
+.TH "KNIFE-ENVIRONMENT" "1" "Chef 12.0" "" "knife environment"
 .SH NAME
 knife-environment \- The man page for the knife environment subcommand.
 .

data/distro/common/man/man1/knife-exec.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-EXEC" "1" "Chef 11.16" "" "knife exec"
+.TH "KNIFE-EXEC" "1" "Chef 12.0" "" "knife exec"
 .SH NAME
 knife-exec \- The man page for the knife exec subcommand.
 .

data/distro/common/man/man1/knife-index-rebuild.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-INDEX-REBUILD" "1" "Chef 11.16" "" "knife index rebuild"
+.TH "KNIFE-INDEX-REBUILD" "1" "Chef 12.0" "" "knife index rebuild"
 .SH NAME
 knife-index-rebuild \- The man page for the knife index rebuild subcommand.
 .

data/distro/common/man/man1/knife-list.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-LIST" "1" "Chef 11.16" "" "knife list"
+.TH "KNIFE-LIST" "1" "Chef 12.0" "" "knife list"
 .SH NAME
 knife-list \- The man page for the knife list subcommand.
 .

data/distro/common/man/man1/knife-node.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-NODE" "1" "Chef 11.16" "" "knife node"
+.TH "KNIFE-NODE" "1" "Chef 12.0" "" "knife node"
 .SH NAME
 knife-node \- The man page for the knife node subcommand.
 .
@@ -557,10 +557,10 @@ This argument has the following options:
 The attribute (or attributes) to show.
 .TP
 .B \fB\-l\fP, \fB\-\-long\fP
-Display long output when searching nodes while using the default summary format.
+Use to display all attributes in the output and to show the output as JSON\&.
 .TP
 .B \fB\-m\fP, \fB\-\-medium\fP
-Display more, but not all, of a node\(aqs data when searching using the default summary format.
+Use to display normal attributes in the output and to show the output as JSON\&.
 .TP
 .B \fB\-r\fP, \fB\-\-run\-list\fP
 Use to show only the run\-list.

data/distro/common/man/man1/knife-raw.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-RAW" "1" "Chef 11.16" "" "knife raw"
+.TH "KNIFE-RAW" "1" "Chef 12.0" "" "knife raw"
 .SH NAME
 knife-raw \- The man page for the knife raw subcommand.
 .
@@ -31,7 +31,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 .sp
-The \fBknife raw\fP subcommand is used to send a REST request to a specified path using the Chef server API\&.
+The \fBknife raw\fP subcommand is used to send a REST request to an endpoint in the Chef server API\&.
 .sp
 \fBSyntax\fP
 .sp

data/distro/common/man/man1/knife-recipe-list.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-RECIPE-LIST" "1" "Chef 11.16" "" "knife recipe list"
+.TH "KNIFE-RECIPE-LIST" "1" "Chef 12.0" "" "knife recipe list"
 .SH NAME
 knife-recipe-list \- The man page for the knife recipe list subcommand.
 .

data/distro/common/man/man1/knife-role.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-ROLE" "1" "Chef 11.16" "" "knife role"
+.TH "KNIFE-ROLE" "1" "Chef 12.0" "" "knife role"
 .SH NAME
 knife-role \- The man page for the knife role subcommand.
 .
@@ -31,7 +31,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 .sp
-A role is a way to define certain patterns and processes that exist across nodes in an organization as belonging to a single job function. Each role consists of zero (or more) attributes and a run list. Each node can have zero (or more) roles assigned to it. When a role is run against a node, the configuration details of that node are compared against the attributes of the role, and then the contents of that role\(aqs run list are applied to the node\(aqs configuration details. When a chef\-client runs, it merges its own attributes and run lists with those contained within each assigned role.
+A role is a way to define certain patterns and processes that exist across nodes in an organization as belonging to a single job function. Each role consists of zero (or more) attributes and a run\-list. Each node can have zero (or more) roles assigned to it. When a role is run against a node, the configuration details of that node are compared against the attributes of the role, and then the contents of that role\(aqs run\-list are applied to the node\(aqs configuration details. When a chef\-client runs, it merges its own attributes and run\-lists with those contained within each assigned role.
 .sp
 The \fBknife role\fP subcommand is used to manage the roles that are associated with one or more nodes on a Chef server\&.
 .SH COMMON OPTIONS

data/distro/common/man/man1/knife-search.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-SEARCH" "1" "Chef 11.16" "" "knife search"
+.TH "KNIFE-SEARCH" "1" "Chef 12.0" "" "knife search"
 .SH NAME
 knife-search \- The man page for the knife search subcommand.
 .
@@ -31,7 +31,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 .sp
-Search indexes allow queries to be made for any type of data that is indexed by the Chef server, including data bags (and data bag items), environments, nodes, and roles. A defined query syntax is used to support search patterns like exact, wildcard, range, and fuzzy. A search is a full\-text query that can be done from several locations, including from within a recipe, by using the \fBsearch\fP subcommand in knife, or by using the \fB/search\fP or \fB/search/INDEX\fP endpoints in the Chef server API\&. The search engine is based on Apache Solr and is run from the Chef server\&.
+Search indexes allow queries to be made for any type of data that is indexed by the Chef server, including data bags (and data bag items), environments, nodes, and roles. A defined query syntax is used to support search patterns like exact, wildcard, range, and fuzzy. A search is a full\-text query that can be done from several locations, including from within a recipe, by using the \fBsearch\fP subcommand in knife, the \fBsearch\fP method in the Recipe DSL, and by using the \fB/search\fP or \fB/search/INDEX\fP endpoints in the Chef server API\&. The search engine is based on Apache Solr and is run from the Chef server\&.
 .sp
 The \fBknife search\fP subcommand is used run a search query for information that is indexed on a Chef server\&.
 .sp
@@ -168,10 +168,10 @@ The name of the index to be queried: \fBclient\fP, \fBenvironment\fP, \fBnode\fP
 The private key that knife will use to sign requests made by the API client to the Chef server\&.
 .TP
 .B \fB\-l\fP, \fB\-\-long\fP
-Display long output when searching nodes while using the default summary format.
+Use to display all attributes in the output and to show the output as JSON\&.
 .TP
 .B \fB\-m\fP, \fB\-\-medium\fP
-Display more, but not all, of a node\(aqs data when searching using the default summary format.
+Use to display normal attributes in the output and to show the output as JSON\&.
 .TP
 .B \fB\-o SORT\fP, \fB\-\-sort SORT\fP
 The order in which search results will be sorted.

data/distro/common/man/man1/knife-serve.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-SERVE" "1" "Chef 11.16" "" "knife serve"
+.TH "KNIFE-SERVE" "1" "Chef 12.0" "" "knife serve"
 .SH NAME
 knife-serve \- The man page for the knife serve subcommand.
 .

data/distro/common/man/man1/knife-show.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-SHOW" "1" "Chef 11.16" "" "knife show"
+.TH "KNIFE-SHOW" "1" "Chef 12.0" "" "knife show"
 .SH NAME
 knife-show \- The man page for the knife show subcommand.
 .

data/distro/common/man/man1/knife-ssh.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-SSH" "1" "Chef 11.16" "" "knife ssh"
+.TH "KNIFE-SSH" "1" "Chef 12.0" "" "knife ssh"
 .SH NAME
 knife-ssh \- The man page for the knife ssh subcommand.
 .

data/distro/common/man/man1/knife-ssl-check.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-SSL-CHECK" "1" "Chef 11.16" "" "knife ssl check"
+.TH "KNIFE-SSL-CHECK" "1" "Chef 12.0" "" "knife ssl check"
 .SH NAME
 knife-ssl-check \- The man page for the knife ssl check subcommand.
 .

data/distro/common/man/man1/knife-ssl-fetch.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-SSL-FETCH" "1" "Chef 11.16" "" "knife ssl fetch"
+.TH "KNIFE-SSL-FETCH" "1" "Chef 12.0" "" "knife ssl fetch"
 .SH NAME
 knife-ssl-fetch \- The man page for the knife ssl fetch subcommand.
 .

data/distro/common/man/man1/knife-status.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-STATUS" "1" "Chef 11.16" "" "knife status"
+.TH "KNIFE-STATUS" "1" "Chef 12.0" "" "knife status"
 .SH NAME
 knife-status \- The man page for the knife status subcommand.
 .

data/distro/common/man/man1/knife-tag.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-TAG" "1" "Chef 11.16" "" "knife tag"
+.TH "KNIFE-TAG" "1" "Chef 12.0" "" "knife tag"
 .SH NAME
 knife-tag \- The man page for the knife tag subcommand.
 .

data/distro/common/man/man1/knife-upload.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-UPLOAD" "1" "Chef 11.16" "" "knife upload"
+.TH "KNIFE-UPLOAD" "1" "Chef 12.0" "" "knife upload"
 .SH NAME
 knife-upload \- The man page for the knife upload subcommand.
 .

data/distro/common/man/man1/knife-user.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-USER" "1" "Chef 11.16" "" "knife user"
+.TH "KNIFE-USER" "1" "Chef 12.0" "" "knife user"
 .SH NAME
 knife-user \- The man page for the knife user subcommand.
 .

data/distro/common/man/man1/knife-xargs.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-XARGS" "1" "Chef 11.16" "" "knife xargs"
+.TH "KNIFE-XARGS" "1" "Chef 12.0" "" "knife xargs"
 .SH NAME
 knife-xargs \- The man page for the knife xargs subcommand.
 .

data/distro/common/man/man1/knife.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE" "1" "Chef 11.16" "" "knife"
+.TH "KNIFE" "1" "Chef 12.0" "" "knife"
 .SH NAME
 knife \- The man page for the knife command line tool.
 .

data/distro/common/man/man8/chef-apply.8

@@ -0,0 +1,86 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "CHEF-APPLY" "8" "Chef 12.0" "" "chef-client"
+.SH NAME
+chef-apply \- The man page for the chef-apply command line tool.
+.
+.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
+..
+.sp
+chef\-apply allows a single recipe to be run from the command line.
+.SH OPTIONS
+.sp
+This command has the following syntax:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+chef\-apply name_of_recipe.rb
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This tool has the following options:
+.INDENT 0.0
+.TP
+.B \fB\-e RECIPE_TEXT\fP, \fB\-\-execute RECIPE_TEXT\fP
+Use to execute a resource using a string.
+.TP
+.B \fB\-l LEVEL\fP, \fB\-\-log_level LEVEL\fP
+The level of logging that will be stored in a log file.
+.TP
+.B \fB\-s\fP, \fB\-\-stdin\fP
+Use to execute a resource using standard input.
+.TP
+.B \fB\-v\fP, \fB\-\-version\fP
+The version of the chef\-client\&.
+.TP
+.B \fB\-W\fP, \fB\-\-why\-run\fP
+Use to run the executable in why\-run mode, which is a type of chef\-client run that does everything except modify the system. Use why\-run mode to understand why the chef\-client makes the decisions that it makes and to learn more about the current and proposed state of the system.
+.TP
+.B \fB\-h\fP, \fB\-\-help\fP
+Shows help for the command.
+.UNINDENT
+.SH EXAMPLES
+.sp
+To use chef\-apply to run a recipe named \fBmachinations.rb\fP, enter the following:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ chef\-apply machinations.rb
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Chef
+.\" Generated by docutils manpage writer.
+.

data/distro/common/man/man8/chef-client.8

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "CHEF-CLIENT" "8" "Chef 11.16" "" "chef-client"
+.TH "CHEF-CLIENT" "8" "Chef 12.0" "" "chef-client"
 .SH NAME
 chef-client \- The man page for the chef-client command line tool.
 .
@@ -86,7 +86,7 @@ This command has the following options:
 Use to cause a chef\-client run to fail when the chef\-client does not have administrator privileges in Microsoft Windows\&.
 .TP
 .B \fB\-\-chef\-zero\-port PORT\fP
-The port on which chef\-zero will listen.
+The port on which chef\-zero will listen. If a port is not specified\-\-\-individually, as range of ports, or from the \fBchef_zero.port\fP setting in the client.rb file\-\-\-the chef\-client will scan for ports between 8889\-9999 and will pick the first port that is available.
 .TP
 .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
 The output format: \fBdoc\fP (default) or \fBmin\fP\&.
@@ -110,10 +110,81 @@ The name of the group that owns a process. This is required when starting any ex
 Shows help for the command.
 .TP
 .B \fB\-i SECONDS\fP, \fB\-\-interval SECONDS\fP
-The frequency (in seconds) at which the chef\-client runs. Default value: \fB1800\fP\&.
+The frequency (in seconds) at which the chef\-client runs. When the chef\-client is run at intervals, \fB\-\-splay\fP and \fB\-\-interval\fP values are applied before the chef\-client run. Default value: \fB1800\fP\&.
 .TP
 .B \fB\-j PATH\fP, \fB\-\-json\-attributes PATH\fP
 The path to a file that contains JSON data.
+.sp
+Use this option to define a \fBrun_list\fP object. For example, a JSON file similar to:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+"run_list": [
+  "recipe[base]",
+  "recipe[foo]",
+  "recipe[bar]",
+  "role[webserver]"
+],
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+may be used by running \fBchef\-client \-j path/to/file.json\fP\&.
+.sp
+In certain situations this option may be used to update \fBnormal\fP attributes.
+.sp
+\fBWARNING:\fP
+.INDENT 7.0
+.INDENT 3.5
+Any other attribute type that is contained in this JSON file will be treated as a \fBnormal\fP attribute. For example, attempting to update \fBoverride\fP attributes using the \fB\-j\fP option:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+{
+  "name": "dev\-99",
+  "description": "Install some stuff",
+  "override_attributes": {
+    "apptastic": {
+      "enable_apptastic": "false",
+      "apptastic_tier_name": "dev\-99.bomb.com"
+    }
+  }
+}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+will result in a node object similar to:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+{
+  "name": "maybe\-dev\-99",
+  "normal": {
+  "name": "dev\-99",
+    "description": "Install some stuff",
+    "override_attributes": {
+      "apptastic": {
+        "enable_apptastic": "false",
+        "apptastic_tier_name": "dev\-99.bomb.com"
+      }
+    }
+  }
+}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
 .TP
 .B \fB\-k KEY_FILE\fP, \fB\-\-client_key KEY_FILE\fP
 The location of the file which contains the client key. Default value: \fB/etc/chef/client.pem\fP\&.
@@ -134,7 +205,7 @@ Use to view colored output. Default setting: \fB\-\-color\fP\&.
 The name of the node.
 .TP
 .B \fB\-o RUN_LIST_ITEM\fP, \fB\-\-override\-runlist RUN_LIST_ITEM\fP
-Replace the current run list with the specified items.
+Replace the current run list with the specified items. This option will not clear the list of cookbooks (and related files) that is cached on the node.
 .TP
 .B \fB\-\-once\fP
 Use to run the chef\-client only once and to cancel \fBinterval\fP and \fBsplay\fP options.
@@ -155,7 +226,7 @@ The path to a recipe. For example, if a recipe file is in the current directory,
 The amount of time (in seconds) to wait for a chef\-client run to finish. Default value: not set (indefinite). Set to \fB0\fP to cause a second chef\-client to exit immediately.
 .TP
 .B \fB\-s SECONDS\fP, \fB\-\-splay SECONDS\fP
-A number (in seconds) to add to the \fBinterval\fP that is used to determine the frequency of chef\-client runs. This number can help prevent server load when there are many clients running at the same time.
+A number (in seconds) to add to the \fBinterval\fP that is used to determine the frequency of chef\-client runs. This number can help prevent server load when there are many clients running at the same time. When the chef\-client is run at intervals, \fB\-\-splay\fP and \fB\-\-interval\fP values are applied before the chef\-client run.
 .TP
 .B \fB\-S CHEF_SERVER_URL\fP, \fB\-\-server CHEF_SERVER_URL\fP
 The URL for the Chef server\&.