chef 11.14.0.alpha.4 → 11.14.0.rc.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (145) hide show
  1. data/CONTRIBUTING.md +0 -4
  2. data/README.md +1 -1
  3. data/distro/common/man/man1/chef-shell.1 +4 -4
  4. data/distro/common/man/man1/knife-bootstrap.1 +14 -11
  5. data/distro/common/man/man1/knife-client.1 +14 -11
  6. data/distro/common/man/man1/knife-configure.1 +7 -7
  7. data/distro/common/man/man1/knife-cookbook-site.1 +23 -23
  8. data/distro/common/man/man1/knife-cookbook.1 +23 -23
  9. data/distro/common/man/man1/knife-data-bag.1 +13 -13
  10. data/distro/common/man/man1/knife-delete.1 +9 -9
  11. data/distro/common/man/man1/knife-deps.1 +9 -9
  12. data/distro/common/man/man1/knife-diff.1 +10 -10
  13. data/distro/common/man/man1/knife-download.1 +9 -9
  14. data/distro/common/man/man1/knife-edit.1 +7 -7
  15. data/distro/common/man/man1/knife-environment.1 +10 -10
  16. data/distro/common/man/man1/knife-exec.1 +7 -7
  17. data/distro/common/man/man1/knife-index-rebuild.1 +1 -1
  18. data/distro/common/man/man1/knife-list.1 +12 -12
  19. data/distro/common/man/man1/knife-node.1 +12 -9
  20. data/distro/common/man/man1/knife-raw.1 +7 -7
  21. data/distro/common/man/man1/knife-recipe-list.1 +1 -1
  22. data/distro/common/man/man1/knife-role.1 +8 -8
  23. data/distro/common/man/man1/knife-search.1 +9 -9
  24. data/distro/common/man/man1/knife-serve.1 +109 -0
  25. data/distro/common/man/man1/knife-show.1 +8 -8
  26. data/distro/common/man/man1/knife-ssh.1 +9 -9
  27. data/distro/common/man/man1/knife-ssl-check.1 +9 -9
  28. data/distro/common/man/man1/knife-ssl-fetch.1 +10 -10
  29. data/distro/common/man/man1/knife-status.1 +9 -9
  30. data/distro/common/man/man1/knife-tag.1 +7 -7
  31. data/distro/common/man/man1/knife-upload.1 +10 -10
  32. data/distro/common/man/man1/knife-user.1 +9 -9
  33. data/distro/common/man/man1/knife-xargs.1 +7 -7
  34. data/distro/common/man/man1/knife.1 +118 -14
  35. data/distro/common/man/man8/chef-client.8 +13 -10
  36. data/distro/common/man/man8/chef-solo.8 +13 -14
  37. data/distro/common/markdown/man1/knife.mkd +1 -1
  38. data/lib/chef/application/knife.rb +1 -1
  39. data/lib/chef/application/windows_service.rb +0 -1
  40. data/lib/chef/chef_fs/file_system.rb +6 -2
  41. data/lib/chef/config.rb +3 -2
  42. data/lib/chef/config_fetcher.rb +1 -1
  43. data/lib/chef/cookbook/metadata.rb +20 -14
  44. data/lib/chef/cookbook/synchronizer.rb +24 -13
  45. data/lib/chef/encrypted_data_bag_item/decryptor.rb +3 -3
  46. data/lib/chef/encrypted_data_bag_item/encryptor.rb +2 -2
  47. data/lib/chef/exceptions.rb +1 -0
  48. data/lib/chef/file_content_management/deploy/mv_windows.rb +1 -1
  49. data/lib/chef/formatters/error_inspectors/resource_failure_inspector.rb +1 -1
  50. data/lib/chef/http.rb +6 -1
  51. data/lib/chef/http/http_request.rb +9 -1
  52. data/lib/chef/http/simple.rb +2 -1
  53. data/lib/chef/json_compat.rb +5 -16
  54. data/lib/chef/knife/bootstrap.rb +2 -0
  55. data/lib/chef/knife/bootstrap/archlinux-gems.erb +2 -2
  56. data/lib/chef/knife/core/object_loader.rb +3 -1
  57. data/lib/chef/knife/ssh.rb +14 -7
  58. data/lib/chef/mixin/convert_to_class_name.rb +1 -0
  59. data/lib/chef/mixin/windows_architecture_helper.rb +24 -4
  60. data/lib/chef/platform/provider_mapping.rb +13 -0
  61. data/lib/chef/provider/env/windows.rb +3 -6
  62. data/lib/chef/provider/git.rb +1 -2
  63. data/lib/chef/provider/log.rb +15 -1
  64. data/lib/chef/provider/package/apt.rb +3 -3
  65. data/lib/chef/provider/package/dpkg.rb +35 -16
  66. data/lib/chef/provider/package/paludis.rb +91 -0
  67. data/lib/chef/provider/package/rpm.rb +3 -2
  68. data/lib/chef/provider/package/yum-dump.py +6 -6
  69. data/lib/chef/provider/package/yum.rb +2 -0
  70. data/lib/chef/provider/registry_key.rb +4 -5
  71. data/lib/chef/provider/remote_file/cache_control_data.rb +1 -1
  72. data/lib/chef/provider/service/solaris.rb +1 -1
  73. data/lib/chef/provider/service/upstart.rb +2 -1
  74. data/lib/chef/provider/service/windows.rb +37 -9
  75. data/lib/chef/provider/user/pw.rb +1 -1
  76. data/lib/chef/provider/user/useradd.rb +1 -1
  77. data/lib/chef/provider/windows_script.rb +2 -1
  78. data/lib/chef/providers.rb +1 -0
  79. data/lib/chef/resource.rb +10 -0
  80. data/lib/chef/resource/file.rb +0 -9
  81. data/lib/chef/resource/package.rb +14 -4
  82. data/lib/chef/resource/paludis_package.rb +33 -0
  83. data/lib/chef/resource/registry_key.rb +62 -3
  84. data/lib/chef/resource/service.rb +21 -4
  85. data/lib/chef/resource_reporter.rb +10 -0
  86. data/lib/chef/resources.rb +1 -0
  87. data/lib/chef/role.rb +14 -10
  88. data/lib/chef/shell.rb +8 -0
  89. data/lib/chef/shell/shell_session.rb +3 -3
  90. data/lib/chef/user.rb +12 -11
  91. data/lib/chef/util/selinux.rb +1 -1
  92. data/lib/chef/version.rb +1 -1
  93. data/lib/chef/version_constraint.rb +6 -5
  94. data/lib/chef/win32/api/process.rb +1 -0
  95. data/lib/chef/win32/api/system.rb +14 -0
  96. data/lib/chef/win32/error.rb +1 -1
  97. data/lib/chef/win32/security.rb +5 -5
  98. data/lib/chef/win32/version.rb +6 -2
  99. data/spec/data/trusted_certs/opscode.pem +57 -35
  100. data/spec/functional/application_spec.rb +2 -2
  101. data/spec/functional/resource/mount_spec.rb +3 -1
  102. data/spec/functional/shell_spec.rb +10 -0
  103. data/spec/functional/tiny_server_spec.rb +2 -2
  104. data/spec/support/chef_helpers.rb +1 -1
  105. data/spec/support/shared/functional/securable_resource.rb +11 -2
  106. data/spec/support/shared/functional/securable_resource_with_reporting.rb +13 -2
  107. data/spec/tiny_server.rb +1 -1
  108. data/spec/unit/config_spec.rb +5 -0
  109. data/spec/unit/cookbook/metadata_spec.rb +24 -0
  110. data/spec/unit/environment_spec.rb +6 -0
  111. data/spec/unit/http/http_request_spec.rb +91 -0
  112. data/spec/unit/http_spec.rb +23 -0
  113. data/spec/unit/knife/bootstrap_spec.rb +2 -2
  114. data/spec/unit/knife/ssh_spec.rb +7 -13
  115. data/spec/unit/knife_spec.rb +1 -1
  116. data/spec/unit/mixin/convert_to_class_name_spec.rb +4 -0
  117. data/spec/unit/provider/git_spec.rb +2 -2
  118. data/spec/unit/provider/log_spec.rb +18 -0
  119. data/spec/unit/provider/mount/solaris_spec.rb +3 -1
  120. data/spec/unit/provider/package/apt_spec.rb +85 -40
  121. data/spec/unit/provider/package/dpkg_spec.rb +24 -48
  122. data/spec/unit/provider/package/paludis_spec.rb +135 -0
  123. data/spec/unit/provider/package/rpm_spec.rb +40 -32
  124. data/spec/unit/provider/package/yum_spec.rb +11 -4
  125. data/spec/unit/provider/registry_key_spec.rb +67 -53
  126. data/spec/unit/provider/remote_file/cache_control_data_spec.rb +10 -1
  127. data/spec/unit/provider/service/solaris_smf_service_spec.rb +23 -2
  128. data/spec/unit/provider/service/upstart_service_spec.rb +7 -0
  129. data/spec/unit/provider/service/windows_spec.rb +72 -0
  130. data/spec/unit/provider/user/pw_spec.rb +21 -4
  131. data/spec/unit/provider/user/useradd_spec.rb +10 -0
  132. data/spec/unit/resource/package_spec.rb +26 -18
  133. data/spec/unit/resource/registry_key_spec.rb +28 -0
  134. data/spec/unit/resource/service_spec.rb +14 -0
  135. data/spec/unit/resource_reporter_spec.rb +37 -12
  136. data/spec/unit/resource_spec.rb +41 -6
  137. data/spec/unit/rest_spec.rb +2 -2
  138. data/spec/unit/role_spec.rb +46 -28
  139. data/spec/unit/shell/shell_session_spec.rb +42 -2
  140. data/spec/unit/shell_spec.rb +1 -1
  141. data/spec/unit/user_spec.rb +12 -0
  142. data/spec/unit/util/selinux_spec.rb +4 -4
  143. data/spec/unit/version_constraint_spec.rb +14 -2
  144. metadata +195 -161
  145. checksums.yaml +0 -7
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-SHOW" "1" "Chef 11.12.0" "" "knife show"
3
+ .TH "KNIFE-SHOW" "1" "Chef 11.14" "" "knife show"
4
4
  .SH NAME
5
5
  knife-show \- The man page for the knife show subcommand.
6
6
  .
@@ -65,16 +65,16 @@ The path to the chef\-repo\&. This setting will override the default path to the
65
65
  The port on which chef\-zero will listen.
66
66
  .TP
67
67
  .B \fB\-\-[no\-]color\fP
68
- Indicates whether colored output will be used.
68
+ Use to view colored output.
69
69
  .TP
70
70
  .B \fB\-\-concurrency\fP
71
71
  The number of allowed concurrent connections. Default: \fB10\fP\&.
72
72
  .TP
73
73
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
74
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
74
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
75
75
  .TP
76
76
  .B \fB\-\-defaults\fP
77
- Indicates that Knife will use the default value, instead of asking a user to provide one.
77
+ Use to have Knife use the default value instead of asking a user to provide one.
78
78
  .TP
79
79
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
80
80
  The $EDITOR that is used for all interactive commands.
@@ -92,10 +92,10 @@ Shows help for the command.
92
92
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
93
93
  .TP
94
94
  .B \fB\-\-local\fP
95
- Indicates that instead of remote files, local files will be shown.
95
+ Use to show local files instead of remote files.
96
96
  .TP
97
97
  .B \fB\-\-print\-after\fP
98
- Indicates that data will be shown after a destructive operation.
98
+ Use to show data after a destructive operation.
99
99
  .TP
100
100
  .B \fB\-\-repo\-mode MODE\fP
101
101
  The layout of the local chef\-repo\&. Possible values: \fBstatic\fP, \fBeverything\fP, or \fBhosted_everything\fP\&. Use \fBstatic\fP for just roles, environments, cookbooks, and data bags. By default, \fBeverything\fP and \fBhosted_everything\fP are dynamically selected depending on the server type. Default: \fBeverything\fP / \fBhosted_everything\fP\&.
@@ -113,10 +113,10 @@ The version of the chef\-client\&.
113
113
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
114
114
  .TP
115
115
  .B \fB\-y\fP, \fB\-\-yes\fP
116
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
116
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
117
117
  .TP
118
118
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
119
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
119
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
120
120
  .UNINDENT
121
121
  .sp
122
122
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-SSH" "1" "Chef 11.12.0" "" "knife ssh"
3
+ .TH "KNIFE-SSH" "1" "Chef 11.14" "" "knife ssh"
4
4
  .SH NAME
5
5
  knife-ssh \- The man page for the knife ssh subcommand.
6
6
  .
@@ -56,7 +56,7 @@ This subcommand has the following options:
56
56
  The attribute that is used when opening the SSH connection. The default attribute is the FQDN of the host. Other possible values include a public IP address, a private IP address, or a hostname.
57
57
  .TP
58
58
  .B \fB\-A\fP, \fB\-\-forward\-agent\fP
59
- Indicates that SSH agent forwarding is enabled.
59
+ Use to enable SSH agent forwarding.
60
60
  .TP
61
61
  .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
62
62
  The configuration file to use.
@@ -68,13 +68,13 @@ The number of allowed concurrent connections.
68
68
  The port on which chef\-zero will listen.
69
69
  .TP
70
70
  .B \fB\-\-[no\-]color\fP
71
- Indicates whether colored output will be used.
71
+ Use to view colored output.
72
72
  .TP
73
73
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
74
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
74
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
75
75
  .TP
76
76
  .B \fB\-\-defaults\fP
77
- Indicates that Knife will use the default value, instead of asking a user to provide one.
77
+ Use to have Knife use the default value instead of asking a user to provide one.
78
78
  .TP
79
79
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
80
80
  The $EDITOR that is used for all interactive commands.
@@ -98,7 +98,7 @@ The SSH identity file used for authentication. Key\-based authentication is reco
98
98
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
99
99
  .TP
100
100
  .B \fB\-m\fP, \fB\-\-manual\-list\fP
101
- Indicates that a search query is a space\-separated list of servers. If there is more than one item in the list, put quotes around the entire list. For example: \fB\-\-manual\-list "server01 server 02 server 03"\fP
101
+ Use to define a search query as a space\-separated list of servers. If there is more than one item in the list, put quotes around the entire list. For example: \fB\-\-manual\-list "server01 server 02 server 03"\fP
102
102
  .TP
103
103
  .B \fB\-\-[no\-]host\-key\-verify\fP
104
104
  Use \fB\-\-no\-host\-key\-verify\fP to disable host key verification. Default setting: \fB\-\-host\-key\-verify\fP\&.
@@ -113,7 +113,7 @@ The SSH port.
113
113
  The SSH password. This can be used to pass the password directly on the command line. If this option is not specified (and a password is required) Knife will prompt for the password.
114
114
  .TP
115
115
  .B \fB\-\-print\-after\fP
116
- Indicates that data will be shown after a destructive operation.
116
+ Use to show data after a destructive operation.
117
117
  .TP
118
118
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
119
119
  The URL for the Chef server\&.
@@ -137,10 +137,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
137
137
  The SSH user name.
138
138
  .TP
139
139
  .B \fB\-y\fP, \fB\-\-yes\fP
140
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
140
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
141
141
  .TP
142
142
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
143
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
143
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
144
144
  .UNINDENT
145
145
  .sp
146
146
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-SSL-CHECK" "1" "Chef 11.12.0" "" "knife ssl check"
3
+ .TH "KNIFE-SSL-CHECK" "1" "Chef 11.14" "" "knife ssl check"
4
4
  .SH NAME
5
5
  knife-ssl-check \- The man page for the knife ssl check subcommand.
6
6
  .
@@ -63,7 +63,7 @@ This subcommand has the following options:
63
63
  The attribute that is used when opening the SSH connection. The default attribute is the FQDN of the host. Other possible values include a public IP address, a private IP address, or a hostname.
64
64
  .TP
65
65
  .B \fB\-A\fP, \fB\-\-forward\-agent\fP
66
- Indicates that SSH agent forwarding is enabled.
66
+ Use to enable SSH agent forwarding.
67
67
  .TP
68
68
  .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
69
69
  The configuration file to use.
@@ -75,13 +75,13 @@ The number of allowed concurrent connections.
75
75
  The port on which chef\-zero will listen.
76
76
  .TP
77
77
  .B \fB\-\-[no\-]color\fP
78
- Indicates whether colored output will be used.
78
+ Use to view colored output.
79
79
  .TP
80
80
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
81
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
81
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
82
82
  .TP
83
83
  .B \fB\-\-defaults\fP
84
- Indicates that Knife will use the default value, instead of asking a user to provide one.
84
+ Use to have Knife use the default value instead of asking a user to provide one.
85
85
  .TP
86
86
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
87
87
  The $EDITOR that is used for all interactive commands.
@@ -105,7 +105,7 @@ The SSH identity file used for authentication. Key\-based authentication is reco
105
105
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
106
106
  .TP
107
107
  .B \fB\-m\fP, \fB\-\-manual\-list\fP
108
- Indicates that a search query is a space\-separated list of servers. If there is more than one item in the list, put quotes around the entire list. For example: \fB\-\-manual\-list "server01 server 02 server 03"\fP
108
+ Use to define a search query as a space\-separated list of servers. If there is more than one item in the list, put quotes around the entire list. For example: \fB\-\-manual\-list "server01 server 02 server 03"\fP
109
109
  .TP
110
110
  .B \fB\-\-[no\-]host\-key\-verify\fP
111
111
  Use \fB\-\-no\-host\-key\-verify\fP to disable host key verification. Default setting: \fB\-\-host\-key\-verify\fP\&.
@@ -120,7 +120,7 @@ The SSH port.
120
120
  The SSH password. This can be used to pass the password directly on the command line. If this option is not specified (and a password is required) Knife will prompt for the password.
121
121
  .TP
122
122
  .B \fB\-\-print\-after\fP
123
- Indicates that data will be shown after a destructive operation.
123
+ Use to show data after a destructive operation.
124
124
  .TP
125
125
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
126
126
  The URL for the Chef server\&.
@@ -144,10 +144,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
144
144
  The SSH user name.
145
145
  .TP
146
146
  .B \fB\-y\fP, \fB\-\-yes\fP
147
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
147
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
148
148
  .TP
149
149
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
150
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
150
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
151
151
  .UNINDENT
152
152
  .sp
153
153
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-SSL-FETCH" "1" "Chef 11.12.0" "" "knife ssl fetch"
3
+ .TH "KNIFE-SSL-FETCH" "1" "Chef 11.14" "" "knife ssl fetch"
4
4
  .SH NAME
5
5
  knife-ssl-fetch \- The man page for the knife ssl fetch subcommand.
6
6
  .
@@ -48,7 +48,7 @@ This subcommand has the following syntax:
48
48
  .sp
49
49
  .nf
50
50
  .ft C
51
- $ knife ssh SEARCH_QUERY SSH_COMMAND (options)
51
+ $ knife ssl fetch URI_FOR_HTTPS_SERVER
52
52
  .ft P
53
53
  .fi
54
54
  .UNINDENT
@@ -63,7 +63,7 @@ This subcommand has the following options:
63
63
  The attribute that is used when opening the SSH connection. The default attribute is the FQDN of the host. Other possible values include a public IP address, a private IP address, or a hostname.
64
64
  .TP
65
65
  .B \fB\-A\fP, \fB\-\-forward\-agent\fP
66
- Indicates that SSH agent forwarding is enabled.
66
+ Use to enable SSH agent forwarding.
67
67
  .TP
68
68
  .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
69
69
  The configuration file to use.
@@ -75,13 +75,13 @@ The number of allowed concurrent connections.
75
75
  The port on which chef\-zero will listen.
76
76
  .TP
77
77
  .B \fB\-\-[no\-]color\fP
78
- Indicates whether colored output will be used.
78
+ Use to view colored output.
79
79
  .TP
80
80
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
81
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
81
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
82
82
  .TP
83
83
  .B \fB\-\-defaults\fP
84
- Indicates that Knife will use the default value, instead of asking a user to provide one.
84
+ Use to have Knife use the default value instead of asking a user to provide one.
85
85
  .TP
86
86
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
87
87
  The $EDITOR that is used for all interactive commands.
@@ -105,7 +105,7 @@ The SSH identity file used for authentication. Key\-based authentication is reco
105
105
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
106
106
  .TP
107
107
  .B \fB\-m\fP, \fB\-\-manual\-list\fP
108
- Indicates that a search query is a space\-separated list of servers. If there is more than one item in the list, put quotes around the entire list. For example: \fB\-\-manual\-list "server01 server 02 server 03"\fP
108
+ Use to define a search query as a space\-separated list of servers. If there is more than one item in the list, put quotes around the entire list. For example: \fB\-\-manual\-list "server01 server 02 server 03"\fP
109
109
  .TP
110
110
  .B \fB\-\-[no\-]host\-key\-verify\fP
111
111
  Use \fB\-\-no\-host\-key\-verify\fP to disable host key verification. Default setting: \fB\-\-host\-key\-verify\fP\&.
@@ -120,7 +120,7 @@ The SSH port.
120
120
  The SSH password. This can be used to pass the password directly on the command line. If this option is not specified (and a password is required) Knife will prompt for the password.
121
121
  .TP
122
122
  .B \fB\-\-print\-after\fP
123
- Indicates that data will be shown after a destructive operation.
123
+ Use to show data after a destructive operation.
124
124
  .TP
125
125
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
126
126
  The URL for the Chef server\&.
@@ -144,10 +144,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
144
144
  The SSH user name.
145
145
  .TP
146
146
  .B \fB\-y\fP, \fB\-\-yes\fP
147
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
147
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
148
148
  .TP
149
149
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
150
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
150
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
151
151
  .UNINDENT
152
152
  .sp
153
153
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-STATUS" "1" "Chef 11.12.0" "" "knife status"
3
+ .TH "KNIFE-STATUS" "1" "Chef 11.14" "" "knife status"
4
4
  .SH NAME
5
5
  knife-status \- The man page for the knife status subcommand.
6
6
  .
@@ -59,13 +59,13 @@ The configuration file to use.
59
59
  The port on which chef\-zero will listen.
60
60
  .TP
61
61
  .B \fB\-\-[no\-]color\fP
62
- Indicates whether colored output will be used.
62
+ Use to view colored output.
63
63
  .TP
64
64
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
65
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
65
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
66
66
  .TP
67
67
  .B \fB\-\-defaults\fP
68
- Indicates that Knife will use the default value, instead of asking a user to provide one.
68
+ Use to have Knife use the default value instead of asking a user to provide one.
69
69
  .TP
70
70
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
71
71
  The $EDITOR that is used for all interactive commands.
@@ -80,13 +80,13 @@ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP,
80
80
  Shows help for the command.
81
81
  .TP
82
82
  .B \fB\-H\fP, \fB\-\-hide\-healthy\fP
83
- Indicates that nodes on which a chef\-client run has occurred within the previous hour will be hidden.
83
+ Use to hide nodes on which a chef\-client run has occurred within the previous hour.
84
84
  .TP
85
85
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
86
86
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
87
87
  .TP
88
88
  .B \fB\-\-print\-after\fP
89
- Indicates that data will be shown after a destructive operation.
89
+ Use to show data after a destructive operation.
90
90
  .TP
91
91
  .B \fBSEARCH_QUERY\fP
92
92
  The search query used to identify a a list of items on a Chef server\&. This option uses the same syntax as the \fBsearch\fP sub\-command.
@@ -95,7 +95,7 @@ The search query used to identify a a list of items on a Chef server\&. This opt
95
95
  A comma\-separated list of roles and/or recipes to be applied.
96
96
  .TP
97
97
  .B \fB\-s\fP, \fB\-\-sort\-reverse\fP
98
- Indicates that the list will be sorted by last run time, descending.
98
+ Use to sort a list by last run time, descending.
99
99
  .TP
100
100
  .B \fB\-\-server\-url URL\fP
101
101
  The URL for the Chef server\&.
@@ -110,10 +110,10 @@ The version of the chef\-client\&.
110
110
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
111
111
  .TP
112
112
  .B \fB\-y\fP, \fB\-\-yes\fP
113
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
113
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
114
114
  .TP
115
115
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
116
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
116
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
117
117
  .UNINDENT
118
118
  .sp
119
119
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-TAG" "1" "Chef 11.12.0" "" "knife tag"
3
+ .TH "KNIFE-TAG" "1" "Chef 11.14" "" "knife tag"
4
4
  .SH NAME
5
5
  knife-tag \- The man page for the knife tag subcommand.
6
6
  .
@@ -46,10 +46,10 @@ The port on which chef\-zero will listen.
46
46
  The configuration file to use.
47
47
  .TP
48
48
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
49
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
49
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
50
50
  .TP
51
51
  .B \fB\-\-defaults\fP
52
- Indicates that Knife will use the default value, instead of asking a user to provide one.
52
+ Use to have Knife use the default value instead of asking a user to provide one.
53
53
  .TP
54
54
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
55
55
  The $EDITOR that is used for all interactive commands.
@@ -67,10 +67,10 @@ Shows help for the command.
67
67
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
68
68
  .TP
69
69
  .B \fB\-\-[no\-]color\fP
70
- Indicates whether colored output will be used.
70
+ Use to view colored output.
71
71
  .TP
72
72
  .B \fB\-\-print\-after\fP
73
- Indicates that data will be shown after a destructive operation.
73
+ Use to show data after a destructive operation.
74
74
  .TP
75
75
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
76
76
  The URL for the Chef server\&.
@@ -85,10 +85,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
85
85
  The version of the chef\-client\&.
86
86
  .TP
87
87
  .B \fB\-y\fP, \fB\-\-yes\fP
88
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
88
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
89
89
  .TP
90
90
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
91
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
91
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
92
92
  .UNINDENT
93
93
  .SH CREATE
94
94
  .sp
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-UPLOAD" "1" "Chef 11.12.0" "" "knife upload"
3
+ .TH "KNIFE-UPLOAD" "1" "Chef 11.14" "" "knife upload"
4
4
  .SH NAME
5
5
  knife-upload \- The man page for the knife upload subcommand.
6
6
  .
@@ -62,19 +62,19 @@ The path to the chef\-repo\&. This setting will override the default path to the
62
62
  The port on which chef\-zero will listen.
63
63
  .TP
64
64
  .B \fB\-\-[no\-]color\fP
65
- Indicates whether colored output will be used.
65
+ Use to view colored output.
66
66
  .TP
67
67
  .B \fB\-\-concurrency\fP
68
68
  The number of allowed concurrent connections. Default: \fB10\fP\&.
69
69
  .TP
70
70
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
71
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
71
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
72
72
  .TP
73
73
  .B \fB\-\-defaults\fP
74
- Indicates that Knife will use the default value, instead of asking a user to provide one.
74
+ Use to have Knife use the default value instead of asking a user to provide one.
75
75
  .TP
76
76
  .B \fB\-\-[no\-]diff\fP
77
- Indicates that only new and modified files will be uploaded. Set to \fBfalse\fP to upload all files. Default: \fBtrue\fP\&.
77
+ Use to upload only new and modified files. Set to \fBfalse\fP to upload all files. Default: \fBtrue\fP\&.
78
78
  .TP
79
79
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
80
80
  The $EDITOR that is used for all interactive commands.
@@ -89,7 +89,7 @@ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP,
89
89
  Use \fB\-\-force\fP to upload roles, cookbooks, etc. even if the file in the directory is identical (by default, no \fBPOST\fP or \fBPUT\fP is performed unless an actual change would be made). Default: \fB\-\-no\-force\fP\&.
90
90
  .TP
91
91
  .B \fB\-\-[no\-]freeze\fP
92
- Indicates that a cookbook cannot be modified; any changes to this cookbook must be included as a new version. Only the \fB\-\-force\fP option can override this setting. Default: \fBfalse\fP\&.
92
+ Use to require changes to a cookbook be included as a new version. Only the \fB\-\-force\fP option can override this setting. Default: \fBfalse\fP\&.
93
93
  .TP
94
94
  .B \fB\-h\fP, \fB\-\-help\fP
95
95
  Shows help for the command.
@@ -98,10 +98,10 @@ Shows help for the command.
98
98
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
99
99
  .TP
100
100
  .B \fB\-n\fP, \fB\-\-dry\-run\fP
101
- Indicates that no action is taken and that results are only printed out. Default: \fBfalse\fP\&.
101
+ Use to take no action and only print out results. Default: \fBfalse\fP\&.
102
102
  .TP
103
103
  .B \fB\-\-print\-after\fP
104
- Indicates that data will be shown after a destructive operation.
104
+ Use to show data after a destructive operation.
105
105
  .TP
106
106
  .B \fB\-\-[no\-]purge\fP
107
107
  Use \fB\-\-purge\fP to delete roles, cookbooks, etc. from the Chef server if their corresponding files do not exist in the chef\-repo\&. By default, such objects are left alone and NOT purged. Default: \fB\-\-no\-purge\fP\&.
@@ -125,10 +125,10 @@ The version of the chef\-client\&.
125
125
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
126
126
  .TP
127
127
  .B \fB\-y\fP, \fB\-\-yes\fP
128
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
128
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
129
129
  .TP
130
130
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
131
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
131
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
132
132
  .UNINDENT
133
133
  .sp
134
134
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-USER" "1" "Chef 11.12.0" "" "knife user"
3
+ .TH "KNIFE-USER" "1" "Chef 11.14" "" "knife user"
4
4
  .SH NAME
5
5
  knife-user \- The man page for the knife user subcommand.
6
6
  .
@@ -51,10 +51,10 @@ The port on which chef\-zero will listen.
51
51
  The configuration file to use.
52
52
  .TP
53
53
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
54
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
54
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
55
55
  .TP
56
56
  .B \fB\-\-defaults\fP
57
- Indicates that Knife will use the default value, instead of asking a user to provide one.
57
+ Use to have Knife use the default value instead of asking a user to provide one.
58
58
  .TP
59
59
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
60
60
  The $EDITOR that is used for all interactive commands.
@@ -72,10 +72,10 @@ Shows help for the command.
72
72
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
73
73
  .TP
74
74
  .B \fB\-\-[no\-]color\fP
75
- Indicates whether colored output will be used.
75
+ Use to view colored output.
76
76
  .TP
77
77
  .B \fB\-\-print\-after\fP
78
- Indicates that data will be shown after a destructive operation.
78
+ Use to show data after a destructive operation.
79
79
  .TP
80
80
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
81
81
  The URL for the Chef server\&.
@@ -90,10 +90,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
90
90
  The version of the chef\-client\&.
91
91
  .TP
92
92
  .B \fB\-y\fP, \fB\-\-yes\fP
93
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
93
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
94
94
  .TP
95
95
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
96
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
96
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
97
97
  .UNINDENT
98
98
  .SH CREATE
99
99
  .sp
@@ -125,7 +125,7 @@ This argument has the following options:
125
125
  .INDENT 0.0
126
126
  .TP
127
127
  .B \fB\-a\fP, \fB\-\-admin\fP
128
- Indicates that a client will be created as an admin client. This is required when users of the open source Chef server need to access the Chef Server API as an administrator. This option only works when used with the open source Chef server and will have no effect when used with Enterprise Chef\&.
128
+ Use to create a client as an admin client. This is required for any user to access Open Source Chef as an administrator. This option only works when used with the open source Chef server and will have no effect when used with Enterprise Chef\&.
129
129
  .TP
130
130
  .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
131
131
  Use to save a private key to the specified file name.
@@ -230,7 +230,7 @@ This argument has the following options:
230
230
  .INDENT 0.0
231
231
  .TP
232
232
  .B \fB\-w\fP, \fB\-\-with\-uri\fP
233
- Indicates that the corresponding URIs will be shown.
233
+ Use to show the corresponding URIs.
234
234
  .UNINDENT
235
235
  .sp
236
236
  \fBExamples\fP