chef 13.11.3 → 13.12.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (261) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +4 -3
  3. data/README.md +35 -40
  4. data/Rakefile +18 -22
  5. data/chef-universal-mingw32.gemspec +1 -1
  6. data/chef.gemspec +3 -3
  7. data/lib/chef/client.rb +1 -1
  8. data/lib/chef/mixin/params_validate.rb +3 -1
  9. data/lib/chef/provider/script.rb +2 -2
  10. data/lib/chef/version.rb +1 -1
  11. data/spec/functional/http/simple_spec.rb +12 -6
  12. data/spec/functional/resource/remote_file_spec.rb +19 -15
  13. data/spec/support/platform_helpers.rb +2 -1
  14. data/tasks/announce.rb +1 -1
  15. data/tasks/dependencies.rb +5 -39
  16. data/tasks/maintainers.rb +10 -10
  17. data/tasks/rspec.rb +2 -2
  18. data/tasks/templates/prerelease.md.erb +11 -2
  19. data/tasks/templates/release.md.erb +9 -1
  20. metadata +6 -248
  21. data/CONTRIBUTING.md +0 -151
  22. data/VERSION +0 -1
  23. data/acceptance/.gitignore +0 -3
  24. data/acceptance/.shared/kitchen_acceptance/.kitchen.digitalocean.yml +0 -33
  25. data/acceptance/.shared/kitchen_acceptance/.kitchen.ec2.yml +0 -283
  26. data/acceptance/.shared/kitchen_acceptance/.kitchen.vagrant.yml +0 -59
  27. data/acceptance/.shared/kitchen_acceptance/libraries/kitchen.rb +0 -68
  28. data/acceptance/.shared/kitchen_acceptance/metadata.rb +0 -1
  29. data/acceptance/Gemfile +0 -19
  30. data/acceptance/Gemfile.lock +0 -266
  31. data/acceptance/README.md +0 -137
  32. data/acceptance/basics/.acceptance/acceptance-cookbook/.gitignore +0 -2
  33. data/acceptance/basics/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  34. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  35. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  36. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  37. data/acceptance/basics/.kitchen.yml +0 -4
  38. data/acceptance/basics/test/integration/chef-current-install/serverspec/chef_client_spec.rb +0 -19
  39. data/acceptance/basics/test/integration/chef-current-install/serverspec/spec_helper.rb +0 -6
  40. data/acceptance/basics/test/integration/helpers/serverspec/Gemfile +0 -8
  41. data/acceptance/data-collector/.acceptance/acceptance-cookbook/.gitignore +0 -2
  42. data/acceptance/data-collector/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  43. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -2
  44. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -2
  45. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -2
  46. data/acceptance/data-collector/.acceptance/data-collector-test/.gitignore +0 -16
  47. data/acceptance/data-collector/.acceptance/data-collector-test/Berksfile +0 -3
  48. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/api.rb +0 -101
  49. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/apigemfile +0 -3
  50. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-both-mode.rb +0 -4
  51. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-client-mode.rb +0 -4
  52. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-no-endpoint.rb +0 -2
  53. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-solo-mode.rb +0 -4
  54. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/config.ru +0 -2
  55. data/acceptance/data-collector/.acceptance/data-collector-test/metadata.rb +0 -7
  56. data/acceptance/data-collector/.acceptance/data-collector-test/recipes/default.rb +0 -44
  57. data/acceptance/data-collector/.kitchen.yml +0 -9
  58. data/acceptance/data-collector/Berksfile +0 -3
  59. data/acceptance/data-collector/test/integration/default/serverspec/default_spec.rb +0 -208
  60. data/acceptance/data-collector/test/integration/helpers/serverspec/Gemfile +0 -8
  61. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/.gitignore +0 -2
  62. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/metadata.rb +0 -1
  63. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  64. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  65. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -61
  66. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/.gitignore +0 -2
  67. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/cookbook_kitchen.rb +0 -43
  68. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/top_cookbooks.rb +0 -41
  69. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  70. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  71. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  72. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  73. data/acceptance/top-cookbooks/.gitignore +0 -1
  74. data/acceptance/top-cookbooks/.kitchen.chocolatey.yml +0 -6
  75. data/acceptance/top-cookbooks/.kitchen.iis.yml +0 -4
  76. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-rhel.yml +0 -7
  77. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-ubuntu.yml +0 -7
  78. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-windows.yml +0 -7
  79. data/acceptance/top-cookbooks/.kitchen.powershell.yml +0 -4
  80. data/acceptance/top-cookbooks/.kitchen.sql_server.yml +0 -5
  81. data/acceptance/top-cookbooks/.kitchen.winbox.yml +0 -8
  82. data/acceptance/top-cookbooks/.kitchen.windows.yml +0 -38
  83. data/acceptance/trivial/.acceptance/acceptance-cookbook/.gitignore +0 -2
  84. data/acceptance/trivial/.acceptance/acceptance-cookbook/metadata.rb +0 -2
  85. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  86. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  87. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  88. data/acceptance/trivial/.kitchen.yml +0 -7
  89. data/acceptance/trivial/test/integration/chef-current-install/inspec/chef_client_spec.rb +0 -5
  90. data/acceptance/windows-service/.acceptance/acceptance-cookbook/.gitignore +0 -2
  91. data/acceptance/windows-service/.acceptance/acceptance-cookbook/metadata.rb +0 -2
  92. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  93. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  94. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  95. data/acceptance/windows-service/.kitchen.yml +0 -7
  96. data/acceptance/windows-service/test/integration/chef-windows-service/inspec/chef_windows_service_spec.rb +0 -58
  97. data/distro/common/html/_sources/ctl_chef_client.txt +0 -36
  98. data/distro/common/html/_sources/ctl_chef_server.txt +0 -341
  99. data/distro/common/html/_sources/ctl_chef_shell.txt +0 -15
  100. data/distro/common/html/_sources/ctl_chef_solo.txt +0 -25
  101. data/distro/common/html/_sources/index.txt +0 -135
  102. data/distro/common/html/_sources/knife.txt +0 -74
  103. data/distro/common/html/_sources/knife_bootstrap.txt +0 -56
  104. data/distro/common/html/_sources/knife_client.txt +0 -151
  105. data/distro/common/html/_sources/knife_common_options.txt +0 -6
  106. data/distro/common/html/_sources/knife_configure.txt +0 -29
  107. data/distro/common/html/_sources/knife_cookbook.txt +0 -236
  108. data/distro/common/html/_sources/knife_cookbook_site.txt +0 -157
  109. data/distro/common/html/_sources/knife_data_bag.txt +0 -160
  110. data/distro/common/html/_sources/knife_delete.txt +0 -26
  111. data/distro/common/html/_sources/knife_deps.txt +0 -61
  112. data/distro/common/html/_sources/knife_diff.txt +0 -34
  113. data/distro/common/html/_sources/knife_download.txt +0 -44
  114. data/distro/common/html/_sources/knife_edit.txt +0 -26
  115. data/distro/common/html/_sources/knife_environment.txt +0 -158
  116. data/distro/common/html/_sources/knife_exec.txt +0 -47
  117. data/distro/common/html/_sources/knife_index_rebuild.txt +0 -21
  118. data/distro/common/html/_sources/knife_list.txt +0 -33
  119. data/distro/common/html/_sources/knife_node.txt +0 -250
  120. data/distro/common/html/_sources/knife_raw.txt +0 -35
  121. data/distro/common/html/_sources/knife_recipe_list.txt +0 -23
  122. data/distro/common/html/_sources/knife_role.txt +0 -157
  123. data/distro/common/html/_sources/knife_search.txt +0 -53
  124. data/distro/common/html/_sources/knife_serve.txt +0 -19
  125. data/distro/common/html/_sources/knife_show.txt +0 -27
  126. data/distro/common/html/_sources/knife_ssh.txt +0 -43
  127. data/distro/common/html/_sources/knife_ssl_check.txt +0 -41
  128. data/distro/common/html/_sources/knife_ssl_fetch.txt +0 -41
  129. data/distro/common/html/_sources/knife_status.txt +0 -37
  130. data/distro/common/html/_sources/knife_tag.txt +0 -69
  131. data/distro/common/html/_sources/knife_upload.txt +0 -49
  132. data/distro/common/html/_sources/knife_user.txt +0 -127
  133. data/distro/common/html/_sources/knife_using.txt +0 -43
  134. data/distro/common/html/_sources/knife_xargs.txt +0 -30
  135. data/distro/common/html/_static/ajax-loader.gif +0 -0
  136. data/distro/common/html/_static/basic.css +0 -537
  137. data/distro/common/html/_static/chef.ico +0 -0
  138. data/distro/common/html/_static/chef_html_logo.png +0 -0
  139. data/distro/common/html/_static/comment-bright.png +0 -0
  140. data/distro/common/html/_static/comment-close.png +0 -0
  141. data/distro/common/html/_static/comment.png +0 -0
  142. data/distro/common/html/_static/contents.png +0 -0
  143. data/distro/common/html/_static/doctools.js +0 -238
  144. data/distro/common/html/_static/down-pressed.png +0 -0
  145. data/distro/common/html/_static/down.png +0 -0
  146. data/distro/common/html/_static/file.png +0 -0
  147. data/distro/common/html/_static/guide.css +0 -505
  148. data/distro/common/html/_static/jquery.js +0 -2
  149. data/distro/common/html/_static/minus.png +0 -0
  150. data/distro/common/html/_static/navigation.png +0 -0
  151. data/distro/common/html/_static/plus.png +0 -0
  152. data/distro/common/html/_static/pygments.css +0 -62
  153. data/distro/common/html/_static/searchtools.js +0 -622
  154. data/distro/common/html/_static/underscore.js +0 -31
  155. data/distro/common/html/_static/up-pressed.png +0 -0
  156. data/distro/common/html/_static/up.png +0 -0
  157. data/distro/common/html/_static/websupport.js +0 -808
  158. data/distro/common/html/ctl_chef_client.html +0 -270
  159. data/distro/common/html/ctl_chef_server.html +0 -728
  160. data/distro/common/html/ctl_chef_shell.html +0 -163
  161. data/distro/common/html/ctl_chef_solo.html +0 -194
  162. data/distro/common/html/index.html +0 -202
  163. data/distro/common/html/knife.html +0 -170
  164. data/distro/common/html/knife_bootstrap.html +0 -285
  165. data/distro/common/html/knife_client.html +0 -285
  166. data/distro/common/html/knife_common_options.html +0 -96
  167. data/distro/common/html/knife_configure.html +0 -105
  168. data/distro/common/html/knife_cookbook.html +0 -487
  169. data/distro/common/html/knife_cookbook_site.html +0 -375
  170. data/distro/common/html/knife_data_bag.html +0 -374
  171. data/distro/common/html/knife_delete.html +0 -93
  172. data/distro/common/html/knife_deps.html +0 -143
  173. data/distro/common/html/knife_diff.html +0 -123
  174. data/distro/common/html/knife_download.html +0 -145
  175. data/distro/common/html/knife_edit.html +0 -89
  176. data/distro/common/html/knife_environment.html +0 -322
  177. data/distro/common/html/knife_exec.html +0 -220
  178. data/distro/common/html/knife_index_rebuild.html +0 -83
  179. data/distro/common/html/knife_list.html +0 -114
  180. data/distro/common/html/knife_node.html +0 -458
  181. data/distro/common/html/knife_raw.html +0 -110
  182. data/distro/common/html/knife_recipe_list.html +0 -91
  183. data/distro/common/html/knife_role.html +0 -295
  184. data/distro/common/html/knife_search.html +0 -203
  185. data/distro/common/html/knife_serve.html +0 -79
  186. data/distro/common/html/knife_show.html +0 -104
  187. data/distro/common/html/knife_ssh.html +0 -177
  188. data/distro/common/html/knife_ssl_check.html +0 -151
  189. data/distro/common/html/knife_ssl_fetch.html +0 -151
  190. data/distro/common/html/knife_status.html +0 -144
  191. data/distro/common/html/knife_tag.html +0 -138
  192. data/distro/common/html/knife_upload.html +0 -153
  193. data/distro/common/html/knife_user.html +0 -242
  194. data/distro/common/html/knife_using.html +0 -210
  195. data/distro/common/html/knife_xargs.html +0 -122
  196. data/distro/common/html/objects.inv +0 -0
  197. data/distro/common/html/search.html +0 -82
  198. data/distro/common/html/searchindex.js +0 -1
  199. data/distro/common/man/man1/README.md +0 -58
  200. data/distro/common/man/man1/chef-shell.1 +0 -194
  201. data/distro/common/man/man1/knife-bootstrap.1 +0 -215
  202. data/distro/common/man/man1/knife-client.1 +0 -443
  203. data/distro/common/man/man1/knife-configure.1 +0 -161
  204. data/distro/common/man/man1/knife-cookbook-site.1 +0 -552
  205. data/distro/common/man/man1/knife-cookbook.1 +0 -770
  206. data/distro/common/man/man1/knife-data-bag.1 +0 -617
  207. data/distro/common/man/man1/knife-delete.1 +0 -127
  208. data/distro/common/man/man1/knife-deps.1 +0 -246
  209. data/distro/common/man/man1/knife-diff.1 +0 -226
  210. data/distro/common/man/man1/knife-download.1 +0 -258
  211. data/distro/common/man/man1/knife-edit.1 +0 -121
  212. data/distro/common/man/man1/knife-environment.1 +0 -496
  213. data/distro/common/man/man1/knife-exec.1 +0 -362
  214. data/distro/common/man/man1/knife-index-rebuild.1 +0 -63
  215. data/distro/common/man/man1/knife-list.1 +0 -174
  216. data/distro/common/man/man1/knife-node.1 +0 -716
  217. data/distro/common/man/man1/knife-raw.1 +0 -172
  218. data/distro/common/man/man1/knife-recipe-list.1 +0 -85
  219. data/distro/common/man/man1/knife-role.1 +0 -426
  220. data/distro/common/man/man1/knife-search.1 +0 -359
  221. data/distro/common/man/man1/knife-serve.1 +0 -109
  222. data/distro/common/man/man1/knife-show.1 +0 -160
  223. data/distro/common/man/man1/knife-ssh.1 +0 -284
  224. data/distro/common/man/man1/knife-ssl-check.1 +0 -207
  225. data/distro/common/man/man1/knife-ssl-fetch.1 +0 -207
  226. data/distro/common/man/man1/knife-status.1 +0 -234
  227. data/distro/common/man/man1/knife-tag.1 +0 -189
  228. data/distro/common/man/man1/knife-upload.1 +0 -280
  229. data/distro/common/man/man1/knife-user.1 +0 -356
  230. data/distro/common/man/man1/knife-xargs.1 +0 -189
  231. data/distro/common/man/man1/knife.1 +0 -332
  232. data/distro/common/man/man8/chef-apply.8 +0 -86
  233. data/distro/common/man/man8/chef-client.8 +0 -398
  234. data/distro/common/man/man8/chef-solo.8 +0 -260
  235. data/distro/common/markdown/README +0 -3
  236. data/distro/common/markdown/man1/chef-shell.mkd +0 -195
  237. data/distro/common/markdown/man1/knife-bootstrap.mkd +0 -141
  238. data/distro/common/markdown/man1/knife-client.mkd +0 -103
  239. data/distro/common/markdown/man1/knife-configure.mkd +0 -71
  240. data/distro/common/markdown/man1/knife-cookbook-site.mkd +0 -123
  241. data/distro/common/markdown/man1/knife-cookbook.mkd +0 -263
  242. data/distro/common/markdown/man1/knife-data-bag.mkd +0 -121
  243. data/distro/common/markdown/man1/knife-environment.mkd +0 -151
  244. data/distro/common/markdown/man1/knife-exec.mkd +0 -42
  245. data/distro/common/markdown/man1/knife-index.mkd +0 -30
  246. data/distro/common/markdown/man1/knife-node.mkd +0 -130
  247. data/distro/common/markdown/man1/knife-role.mkd +0 -85
  248. data/distro/common/markdown/man1/knife-search.mkd +0 -180
  249. data/distro/common/markdown/man1/knife-ssh.mkd +0 -69
  250. data/distro/common/markdown/man1/knife-status.mkd +0 -36
  251. data/distro/common/markdown/man1/knife-tag.mkd +0 -39
  252. data/distro/common/markdown/man1/knife.mkd +0 -213
  253. data/distro/common/markdown/man8/chef-client.mkd +0 -75
  254. data/distro/common/markdown/man8/chef-expander.mkd +0 -81
  255. data/distro/common/markdown/man8/chef-expanderctl.mkd +0 -57
  256. data/distro/common/markdown/man8/chef-server-webui.mkd +0 -121
  257. data/distro/common/markdown/man8/chef-server.mkd +0 -120
  258. data/distro/common/markdown/man8/chef-solo.mkd +0 -107
  259. data/distro/common/markdown/man8/chef-solr.mkd +0 -89
  260. data/distro/powershell/chef/chef.psm1 +0 -459
  261. data/tasks/cbgb.rb +0 -84
@@ -1,160 +0,0 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE-SHOW" "1" "Chef 12.0" "" "knife show"
4
- .SH NAME
5
- knife-show \- The man page for the knife show subcommand.
6
- .
7
- .nr rst2man-indent-level 0
8
- .
9
- .de1 rstReportMargin
10
- \\$1 \\n[an-margin]
11
- level \\n[rst2man-indent-level]
12
- level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
13
- -
14
- \\n[rst2man-indent0]
15
- \\n[rst2man-indent1]
16
- \\n[rst2man-indent2]
17
- ..
18
- .de1 INDENT
19
- .\" .rstReportMargin pre:
20
- . RS \\$1
21
- . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22
- . nr rst2man-indent-level +1
23
- .\" .rstReportMargin post:
24
- ..
25
- .de UNINDENT
26
- . RE
27
- .\" indent \\n[an-margin]
28
- .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
- .nr rst2man-indent-level -1
30
- .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31
- .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32
- ..
33
- .sp
34
- The \fBknife show\fP subcommand is used to view the details of one (or more) objects on the Chef server\&. This subcommand works similar to \fBknife cookbook show\fP, \fBknife data bag show\fP, \fBknife environment show\fP, \fBknife node show\fP, and \fBknife role show\fP, but with a single verb (and a single action).
35
- .sp
36
- \fBSyntax\fP
37
- .sp
38
- This subcommand has the following syntax:
39
- .INDENT 0.0
40
- .INDENT 3.5
41
- .sp
42
- .nf
43
- .ft C
44
- $ knife show [PATTERN...] (options)
45
- .ft P
46
- .fi
47
- .UNINDENT
48
- .UNINDENT
49
- .sp
50
- \fBOptions\fP
51
- .sp
52
- This subcommand has the following options:
53
- .INDENT 0.0
54
- .TP
55
- .B \fB\-a ATTR\fP, \fB\-\-attribute ATTR\fP
56
- The attribute (or attributes) to show.
57
- .TP
58
- .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
59
- The configuration file to use.
60
- .TP
61
- .B \fB\-\-chef\-repo\-path PATH\fP
62
- The path to the chef\-repo\&. This setting will override the default path to the chef\-repo\&. Default: same as specified by \fBchef_repo_path\fP in config.rb.
63
- .TP
64
- .B \fB\-\-chef\-zero\-port PORT\fP
65
- The port on which chef\-zero will listen.
66
- .TP
67
- .B \fB\-\-[no\-]color\fP
68
- Use to view colored output.
69
- .TP
70
- .B \fB\-\-concurrency\fP
71
- The number of allowed concurrent connections. Default: \fB10\fP\&.
72
- .TP
73
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
74
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
75
- .TP
76
- .B \fB\-\-defaults\fP
77
- Use to have knife use the default value instead of asking a user to provide one.
78
- .TP
79
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
80
- The $EDITOR that is used for all interactive commands.
81
- .TP
82
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
83
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
84
- .TP
85
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
86
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
87
- .TP
88
- .B \fB\-h\fP, \fB\-\-help\fP
89
- Shows help for the command.
90
- .TP
91
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
92
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
93
- .TP
94
- .B \fB\-\-local\fP
95
- Use to show local files instead of remote files.
96
- .TP
97
- .B \fB\-\-print\-after\fP
98
- Use to show data after a destructive operation.
99
- .TP
100
- .B \fB\-\-repo\-mode MODE\fP
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\&.
102
- .TP
103
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
104
- The URL for the Chef server\&.
105
- .TP
106
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
107
- The user name used by knife to sign requests made by the API client to the Chef server\&. Authentication will fail if the user name does not match the private key.
108
- .TP
109
- .B \fB\-v\fP, \fB\-\-version\fP
110
- The version of the chef\-client\&.
111
- .TP
112
- .B \fB\-V\fP, \fB\-\-verbose\fP
113
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
114
- .TP
115
- .B \fB\-y\fP, \fB\-\-yes\fP
116
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
117
- .TP
118
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
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
- .UNINDENT
121
- .sp
122
- \fBExamples\fP
123
- .sp
124
- To show all cookbooks in the \fBcookbooks/\fP directory:
125
- .INDENT 0.0
126
- .INDENT 3.5
127
- .sp
128
- .nf
129
- .ft C
130
- $ knife show cookbooks/
131
- .ft P
132
- .fi
133
- .UNINDENT
134
- .UNINDENT
135
- .sp
136
- or, (if already in the \fBcookbooks/\fP directory in the local chef\-repo):
137
- .INDENT 0.0
138
- .INDENT 3.5
139
- .sp
140
- .nf
141
- .ft C
142
- $ knife show
143
- .ft P
144
- .fi
145
- .UNINDENT
146
- .UNINDENT
147
- .INDENT 0.0
148
- .INDENT 3.5
149
- .sp
150
- .nf
151
- .ft C
152
- $ knife show roles/ environments/
153
- .ft P
154
- .fi
155
- .UNINDENT
156
- .UNINDENT
157
- .SH AUTHOR
158
- Chef
159
- .\" Generated by docutils manpage writer.
160
- .
@@ -1,284 +0,0 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE-SSH" "1" "Chef 12.0" "" "knife ssh"
4
- .SH NAME
5
- knife-ssh \- The man page for the knife ssh subcommand.
6
- .
7
- .nr rst2man-indent-level 0
8
- .
9
- .de1 rstReportMargin
10
- \\$1 \\n[an-margin]
11
- level \\n[rst2man-indent-level]
12
- level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
13
- -
14
- \\n[rst2man-indent0]
15
- \\n[rst2man-indent1]
16
- \\n[rst2man-indent2]
17
- ..
18
- .de1 INDENT
19
- .\" .rstReportMargin pre:
20
- . RS \\$1
21
- . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22
- . nr rst2man-indent-level +1
23
- .\" .rstReportMargin post:
24
- ..
25
- .de UNINDENT
26
- . RE
27
- .\" indent \\n[an-margin]
28
- .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
- .nr rst2man-indent-level -1
30
- .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31
- .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32
- ..
33
- .sp
34
- The \fBknife ssh\fP subcommand is used to invoke SSH commands (in parallel) on a subset of nodes within an organization, based on the results of a \fI\%search query\fP made to the Chef server\&.
35
- .sp
36
- \fBSyntax\fP
37
- .sp
38
- This subcommand has the following syntax:
39
- .INDENT 0.0
40
- .INDENT 3.5
41
- .sp
42
- .nf
43
- .ft C
44
- $ knife ssh SEARCH_QUERY SSH_COMMAND (options)
45
- .ft P
46
- .fi
47
- .UNINDENT
48
- .UNINDENT
49
- .sp
50
- \fBOptions\fP
51
- .sp
52
- This subcommand has the following options:
53
- .INDENT 0.0
54
- .TP
55
- .B \fB\-a SSH_ATTR\fP, \fB\-\-attribute SSH_ATTR\fP
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
- .TP
58
- .B \fB\-A\fP, \fB\-\-forward\-agent\fP
59
- Use to enable SSH agent forwarding.
60
- .TP
61
- .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
62
- The configuration file to use.
63
- .TP
64
- .B \fB\-C NUM\fP, \fB\-\-concurrency NUM\fP
65
- The number of allowed concurrent connections.
66
- .TP
67
- .B \fB\-\-chef\-zero\-port PORT\fP
68
- The port on which chef\-zero will listen.
69
- .TP
70
- .B \fB\-\-[no\-]color\fP
71
- Use to view colored output.
72
- .TP
73
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
74
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
75
- .TP
76
- .B \fB\-\-defaults\fP
77
- Use to have knife use the default value instead of asking a user to provide one.
78
- .TP
79
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
80
- The $EDITOR that is used for all interactive commands.
81
- .TP
82
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
83
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
84
- .TP
85
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
86
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
87
- .TP
88
- .B \fB\-G GATEWAY\fP, \fB\-\-ssh\-gateway GATEWAY\fP
89
- The SSH tunnel or gateway that is used to run a bootstrap action on a machine that is not accessible from the workstation.
90
- .TP
91
- .B \fB\-h\fP, \fB\-\-help\fP
92
- Shows help for the command.
93
- .TP
94
- .B \fB\-i IDENTITY_FILE\fP, \fB\-\-identity\-file IDENTIFY_FILE\fP
95
- The SSH identity file used for authentication. Key\-based authentication is recommended.
96
- .TP
97
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
98
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
99
- .TP
100
- .B \fB\-m\fP, \fB\-\-manual\-list\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
- .TP
103
- .B \fB\-\-[no\-]host\-key\-verify\fP
104
- Use \fB\-\-no\-host\-key\-verify\fP to disable host key verification. Default setting: \fB\-\-host\-key\-verify\fP\&.
105
- .TP
106
- .B \fBOTHER\fP
107
- The shell type. Possible values: \fBinteractive\fP, \fBscreen\fP, \fBtmux\fP, \fBmacterm\fP, or \fBcssh\fP\&. (\fBcsshx\fP is deprecated in favor of \fBcssh\fP\&.)
108
- .TP
109
- .B \fB\-p PORT\fP, \fB\-\-ssh\-port PORT\fP
110
- The SSH port.
111
- .TP
112
- .B \fB\-P PASSWORD\fP, \fB\-\-ssh\-password PASSWORD\fP
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
- .TP
115
- .B \fB\-\-print\-after\fP
116
- Use to show data after a destructive operation.
117
- .TP
118
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
119
- The URL for the Chef server\&.
120
- .TP
121
- .B \fBSEARCH_QUERY\fP
122
- The search query used to return a list of servers to be accessed using SSH and the specified \fBSSH_COMMAND\fP\&. This option uses the same syntax as the search sub\-command.
123
- .TP
124
- .B \fBSSH_COMMAND\fP
125
- The command that will be run against the results of a search query.
126
- .TP
127
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
128
- The user name used by knife to sign requests made by the API client to the Chef server\&. Authentication will fail if the user name does not match the private key.
129
- .TP
130
- .B \fB\-v\fP, \fB\-\-version\fP
131
- The version of the chef\-client\&.
132
- .TP
133
- .B \fB\-V\fP, \fB\-\-verbose\fP
134
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
135
- .TP
136
- .B \fB\-x USER_NAME\fP, \fB\-\-ssh\-user USER_NAME\fP
137
- The SSH user name.
138
- .TP
139
- .B \fB\-y\fP, \fB\-\-yes\fP
140
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
141
- .TP
142
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
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
- .UNINDENT
145
- .sp
146
- \fBExamples\fP
147
- .sp
148
- To find the uptime of all of web servers running Ubuntu on the Amazon EC2 platform, enter:
149
- .INDENT 0.0
150
- .INDENT 3.5
151
- .sp
152
- .nf
153
- .ft C
154
- $ knife ssh "role:web" "uptime" \-x ubuntu \-a ec2.public_hostname
155
- .ft P
156
- .fi
157
- .UNINDENT
158
- .UNINDENT
159
- .sp
160
- to return something like:
161
- .INDENT 0.0
162
- .INDENT 3.5
163
- .sp
164
- .nf
165
- .ft C
166
- ec2\-174\-129\-127\-206.compute\-1.amazonaws.com 13:50:47 up 1 day, 23:26, 1 user, load average: 0.25, 0.18, 0.11
167
- ec2\-67\-202\-63\-102.compute\-1.amazonaws.com 13:50:47 up 1 day, 23:33, 1 user, load average: 0.12, 0.13, 0.10
168
- ec2\-184\-73\-9\-250.compute\-1.amazonaws.com 13:50:48 up 16:45, 1 user, load average: 0.30, 0.22, 0.13
169
- ec2\-75\-101\-240\-230.compute\-1.amazonaws.com 13:50:48 up 1 day, 22:59, 1 user, load average: 0.24, 0.17, 0.11
170
- ec2\-184\-73\-60\-141.compute\-1.amazonaws.com 13:50:48 up 1 day, 23:30, 1 user, load average: 0.32, 0.17, 0.15
171
- .ft P
172
- .fi
173
- .UNINDENT
174
- .UNINDENT
175
- .INDENT 0.0
176
- .INDENT 3.5
177
- .sp
178
- .nf
179
- .ft C
180
- $ knife ssh \(aqname:*\(aq \(aqsudo chef\-client\(aq
181
- .ft P
182
- .fi
183
- .UNINDENT
184
- .UNINDENT
185
- .sp
186
- To force a chef\-client run on all of the web servers running Ubuntu on the Amazon EC2 platform, enter:
187
- .INDENT 0.0
188
- .INDENT 3.5
189
- .sp
190
- .nf
191
- .ft C
192
- $ knife ssh "role:web" "sudo chef\-client" \-x ubuntu \-a ec2.public_hostname
193
- .ft P
194
- .fi
195
- .UNINDENT
196
- .UNINDENT
197
- .sp
198
- to return something like:
199
- .INDENT 0.0
200
- .INDENT 3.5
201
- .sp
202
- .nf
203
- .ft C
204
- ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:37 +0000] INFO: Starting Chef Run (Version 0.9.10)
205
- ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:37 +0000] INFO: Starting Chef Run (Version 0.9.10)
206
- ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:38 +0000] INFO: Starting Chef Run (Version 0.9.10)
207
- ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:38 +0000] INFO: Starting Chef Run (Version 0.9.10)
208
- ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:38 +0000] INFO: Starting Chef Run (Version 0.9.10)
209
- ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Chef Run complete in 1.419243 seconds
210
- ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: cleaning the checksum cache
211
- ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Running report handlers
212
- ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Report handlers complete
213
- ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Chef Run complete in 1.578265 seconds
214
- ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: cleaning the checksum cache
215
- ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Running report handlers
216
- ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Report handlers complete
217
- ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Chef Run complete in 1.638884 seconds
218
- ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: cleaning the checksum cache
219
- ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Running report handlers
220
- ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Report handlers complete
221
- ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Chef Run complete in 1.540257 seconds
222
- ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: cleaning the checksum cache
223
- ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Running report handlers
224
- ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Report handlers complete
225
- ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Chef Run complete in 1.502489 seconds
226
- ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: cleaning the checksum cache
227
- ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Running report handlers
228
- ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Report handlers complete
229
- .ft P
230
- .fi
231
- .UNINDENT
232
- .UNINDENT
233
- .sp
234
- To query for all nodes that have the \fBwebserver\fP role and then use SSH to run the command \fBsudo chef\-client\fP, enter:
235
- .INDENT 0.0
236
- .INDENT 3.5
237
- .sp
238
- .nf
239
- .ft C
240
- $ knife ssh "role:webserver" "sudo chef\-client"
241
- .ft P
242
- .fi
243
- .UNINDENT
244
- .UNINDENT
245
- .INDENT 0.0
246
- .INDENT 3.5
247
- .sp
248
- .nf
249
- .ft C
250
- $ knife ssh name:* "sudo aptitude upgrade \-y"
251
- .ft P
252
- .fi
253
- .UNINDENT
254
- .UNINDENT
255
- .sp
256
- To specify the shell type used on the nodes returned by a search query:
257
- .INDENT 0.0
258
- .INDENT 3.5
259
- .sp
260
- .nf
261
- .ft C
262
- $ knife ssh roles:opscode\-omnitruck macterm
263
- .ft P
264
- .fi
265
- .UNINDENT
266
- .UNINDENT
267
- .sp
268
- where \fBscreen\fP is one of the following values: \fBcssh\fP, \fBinteractive\fP, \fBmacterm\fP, \fBscreen\fP, or \fBtmux\fP\&. If the node does not have the shell type installed, knife will return an error similar to the following:
269
- .INDENT 0.0
270
- .INDENT 3.5
271
- .sp
272
- .nf
273
- .ft C
274
- you need the rb\-appscript gem to use knife ssh macterm.
275
- \(ga(sudo) gem install rb\-appscript\(ga to install
276
- ERROR: LoadError: cannot load such file \-\- appscript
277
- .ft P
278
- .fi
279
- .UNINDENT
280
- .UNINDENT
281
- .SH AUTHOR
282
- Chef
283
- .\" Generated by docutils manpage writer.
284
- .
@@ -1,207 +0,0 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE-SSL-CHECK" "1" "Chef 12.0" "" "knife ssl check"
4
- .SH NAME
5
- knife-ssl-check \- The man page for the knife ssl check subcommand.
6
- .
7
- .nr rst2man-indent-level 0
8
- .
9
- .de1 rstReportMargin
10
- \\$1 \\n[an-margin]
11
- level \\n[rst2man-indent-level]
12
- level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
13
- -
14
- \\n[rst2man-indent0]
15
- \\n[rst2man-indent1]
16
- \\n[rst2man-indent2]
17
- ..
18
- .de1 INDENT
19
- .\" .rstReportMargin pre:
20
- . RS \\$1
21
- . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22
- . nr rst2man-indent-level +1
23
- .\" .rstReportMargin post:
24
- ..
25
- .de UNINDENT
26
- . RE
27
- .\" indent \\n[an-margin]
28
- .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
- .nr rst2man-indent-level -1
30
- .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31
- .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32
- ..
33
- .sp
34
- The \fBknife ssl check\fP subcommand is used to verify the SSL configuration for the Enterprise Chef and/or Open Source Chef servers, or at another location specified by a URL or URI.
35
- .sp
36
- \fBWARNING:\fP
37
- .INDENT 0.0
38
- .INDENT 3.5
39
- When verification of a remote server\(aqs SSL certificate is disabled, the chef\-client will issue a warning similar to "SSL validation of HTTPS requests is disabled. HTTPS connections are still encrypted, but the chef\-client is not able to detect forged replies or man\-in\-the\-middle attacks." To configure SSL for the chef\-client, set \fBssl_verify_mode\fP to \fB:verify_peer\fP (recommended) \fBor\fP \fBverify_api_cert\fP to \fBtrue\fP in the client.rb file.
40
- .UNINDENT
41
- .UNINDENT
42
- .sp
43
- \fBSyntax\fP
44
- .sp
45
- This subcommand has the following syntax:
46
- .INDENT 0.0
47
- .INDENT 3.5
48
- .sp
49
- .nf
50
- .ft C
51
- $ knife ssl check URI
52
- .ft P
53
- .fi
54
- .UNINDENT
55
- .UNINDENT
56
- .sp
57
- \fBOptions\fP
58
- .sp
59
- This subcommand has the following options:
60
- .INDENT 0.0
61
- .TP
62
- .B \fB\-a SSH_ATTR\fP, \fB\-\-attribute SSH_ATTR\fP
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
- .TP
65
- .B \fB\-A\fP, \fB\-\-forward\-agent\fP
66
- Use to enable SSH agent forwarding.
67
- .TP
68
- .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
69
- The configuration file to use.
70
- .TP
71
- .B \fB\-C NUM\fP, \fB\-\-concurrency NUM\fP
72
- The number of allowed concurrent connections.
73
- .TP
74
- .B \fB\-\-chef\-zero\-port PORT\fP
75
- The port on which chef\-zero will listen.
76
- .TP
77
- .B \fB\-\-[no\-]color\fP
78
- Use to view colored output.
79
- .TP
80
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
81
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
82
- .TP
83
- .B \fB\-\-defaults\fP
84
- Use to have knife use the default value instead of asking a user to provide one.
85
- .TP
86
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
87
- The $EDITOR that is used for all interactive commands.
88
- .TP
89
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
90
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
91
- .TP
92
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
93
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
94
- .TP
95
- .B \fB\-G GATEWAY\fP, \fB\-\-ssh\-gateway GATEWAY\fP
96
- The SSH tunnel or gateway that is used to run a bootstrap action on a machine that is not accessible from the workstation.
97
- .TP
98
- .B \fB\-h\fP, \fB\-\-help\fP
99
- Shows help for the command.
100
- .TP
101
- .B \fB\-i IDENTITY_FILE\fP, \fB\-\-identity\-file IDENTIFY_FILE\fP
102
- The SSH identity file used for authentication. Key\-based authentication is recommended.
103
- .TP
104
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
105
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
106
- .TP
107
- .B \fB\-m\fP, \fB\-\-manual\-list\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
- .TP
110
- .B \fB\-\-[no\-]host\-key\-verify\fP
111
- Use \fB\-\-no\-host\-key\-verify\fP to disable host key verification. Default setting: \fB\-\-host\-key\-verify\fP\&.
112
- .TP
113
- .B \fBOTHER\fP
114
- The shell type. Possible values: \fBinteractive\fP, \fBscreen\fP, \fBtmux\fP, \fBmacterm\fP, or \fBcssh\fP\&. (\fBcsshx\fP is deprecated in favor of \fBcssh\fP\&.)
115
- .TP
116
- .B \fB\-p PORT\fP, \fB\-\-ssh\-port PORT\fP
117
- The SSH port.
118
- .TP
119
- .B \fB\-P PASSWORD\fP, \fB\-\-ssh\-password PASSWORD\fP
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
- .TP
122
- .B \fB\-\-print\-after\fP
123
- Use to show data after a destructive operation.
124
- .TP
125
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
126
- The URL for the Chef server\&.
127
- .TP
128
- .B \fBSEARCH_QUERY\fP
129
- The search query used to return a list of servers to be accessed using SSH and the specified \fBSSH_COMMAND\fP\&. This option uses the same syntax as the search sub\-command.
130
- .TP
131
- .B \fBSSH_COMMAND\fP
132
- The command that will be run against the results of a search query.
133
- .TP
134
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
135
- The user name used by knife to sign requests made by the API client to the Chef server\&. Authentication will fail if the user name does not match the private key.
136
- .TP
137
- .B \fB\-v\fP, \fB\-\-version\fP
138
- The version of the chef\-client\&.
139
- .TP
140
- .B \fB\-V\fP, \fB\-\-verbose\fP
141
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
142
- .TP
143
- .B \fB\-x USER_NAME\fP, \fB\-\-ssh\-user USER_NAME\fP
144
- The SSH user name.
145
- .TP
146
- .B \fB\-y\fP, \fB\-\-yes\fP
147
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
148
- .TP
149
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
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
- .UNINDENT
152
- .sp
153
- \fBExamples\fP
154
- .sp
155
- The following examples show how to use this knife subcommand:
156
- .sp
157
- \fBVerify the SSL configuration for the Chef server\fP
158
- .INDENT 0.0
159
- .INDENT 3.5
160
- .sp
161
- .nf
162
- .ft C
163
- $ knife ssl check
164
- .ft P
165
- .fi
166
- .UNINDENT
167
- .UNINDENT
168
- .sp
169
- \fBVerify the SSL configuration for the chef\-client\fP
170
- .INDENT 0.0
171
- .INDENT 3.5
172
- .sp
173
- .nf
174
- .ft C
175
- $ knife ssl check \-c /etc/chef/client.rb
176
- .ft P
177
- .fi
178
- .UNINDENT
179
- .UNINDENT
180
- .sp
181
- \fBVerify an external server\(aqs SSL certificate\fP
182
- .INDENT 0.0
183
- .INDENT 3.5
184
- .sp
185
- .nf
186
- .ft C
187
- $ knife ssl check URL_or_URI
188
- .ft P
189
- .fi
190
- .UNINDENT
191
- .UNINDENT
192
- .sp
193
- for example:
194
- .INDENT 0.0
195
- .INDENT 3.5
196
- .sp
197
- .nf
198
- .ft C
199
- $ knife ssl check https://www.getchef.com
200
- .ft P
201
- .fi
202
- .UNINDENT
203
- .UNINDENT
204
- .SH AUTHOR
205
- Chef
206
- .\" Generated by docutils manpage writer.
207
- .