chef 12.12.15 → 12.13.30

Sign up to get free protection for your applications and to get access to all the features.
Files changed (410) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +5 -0
  3. data/LICENSE +201 -201
  4. data/VERSION +1 -1
  5. data/acceptance/.gitignore +2 -0
  6. data/acceptance/.shared/kitchen_acceptance/.kitchen.ec2.yml +1 -12
  7. data/acceptance/.shared/kitchen_acceptance/libraries/kitchen.rb +29 -12
  8. data/acceptance/Gemfile +6 -3
  9. data/acceptance/Gemfile.lock +109 -67
  10. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/top_cookbooks.rb +2 -2
  11. data/acceptance/trivial/.kitchen.yml +1 -1
  12. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -1
  13. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -1
  14. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/verify.rb +1 -1
  15. data/acceptance/windows-service/test/integration/chef-windows-service/inspec/chef_windows_service_spec.rb +4 -4
  16. data/bin/chef-apply +0 -0
  17. data/bin/chef-client +0 -0
  18. data/bin/chef-shell +0 -0
  19. data/bin/chef-solo +0 -0
  20. data/bin/knife +0 -0
  21. data/chef.gemspec +4 -3
  22. data/distro/common/html/_sources/ctl_chef_client.txt +35 -35
  23. data/distro/common/html/_sources/ctl_chef_server.txt +341 -341
  24. data/distro/common/html/_sources/ctl_chef_shell.txt +15 -15
  25. data/distro/common/html/_sources/ctl_chef_solo.txt +25 -25
  26. data/distro/common/html/_sources/index.txt +135 -135
  27. data/distro/common/html/_sources/knife.txt +74 -74
  28. data/distro/common/html/_sources/knife_bootstrap.txt +56 -56
  29. data/distro/common/html/_sources/knife_client.txt +150 -150
  30. data/distro/common/html/_sources/knife_common_options.txt +6 -6
  31. data/distro/common/html/_sources/knife_configure.txt +29 -29
  32. data/distro/common/html/_sources/knife_cookbook.txt +236 -236
  33. data/distro/common/html/_sources/knife_cookbook_site.txt +157 -157
  34. data/distro/common/html/_sources/knife_data_bag.txt +159 -159
  35. data/distro/common/html/_sources/knife_delete.txt +26 -26
  36. data/distro/common/html/_sources/knife_deps.txt +61 -61
  37. data/distro/common/html/_sources/knife_diff.txt +34 -34
  38. data/distro/common/html/_sources/knife_download.txt +44 -44
  39. data/distro/common/html/_sources/knife_edit.txt +26 -26
  40. data/distro/common/html/_sources/knife_environment.txt +158 -158
  41. data/distro/common/html/_sources/knife_exec.txt +47 -47
  42. data/distro/common/html/_sources/knife_index_rebuild.txt +20 -20
  43. data/distro/common/html/_sources/knife_list.txt +33 -33
  44. data/distro/common/html/_sources/knife_node.txt +250 -250
  45. data/distro/common/html/_sources/knife_raw.txt +35 -35
  46. data/distro/common/html/_sources/knife_recipe_list.txt +23 -23
  47. data/distro/common/html/_sources/knife_role.txt +157 -157
  48. data/distro/common/html/_sources/knife_search.txt +53 -53
  49. data/distro/common/html/_sources/knife_serve.txt +18 -18
  50. data/distro/common/html/_sources/knife_show.txt +26 -26
  51. data/distro/common/html/_sources/knife_ssh.txt +43 -43
  52. data/distro/common/html/_sources/knife_ssl_check.txt +41 -41
  53. data/distro/common/html/_sources/knife_ssl_fetch.txt +41 -41
  54. data/distro/common/html/_sources/knife_status.txt +37 -37
  55. data/distro/common/html/_sources/knife_tag.txt +69 -69
  56. data/distro/common/html/_sources/knife_upload.txt +49 -49
  57. data/distro/common/html/_sources/knife_user.txt +127 -127
  58. data/distro/common/html/_sources/knife_using.txt +43 -43
  59. data/distro/common/html/_sources/knife_xargs.txt +30 -30
  60. data/distro/common/html/_static/guide.css +504 -504
  61. data/distro/common/html/_static/pygments.css +61 -61
  62. data/distro/common/html/_static/underscore.js +31 -31
  63. data/distro/common/html/ctl_chef_client.html +269 -269
  64. data/distro/common/html/ctl_chef_server.html +727 -727
  65. data/distro/common/html/ctl_chef_shell.html +162 -162
  66. data/distro/common/html/ctl_chef_solo.html +193 -193
  67. data/distro/common/html/index.html +201 -201
  68. data/distro/common/html/knife.html +169 -169
  69. data/distro/common/html/knife_bootstrap.html +284 -284
  70. data/distro/common/html/knife_client.html +284 -284
  71. data/distro/common/html/knife_common_options.html +95 -95
  72. data/distro/common/html/knife_configure.html +104 -104
  73. data/distro/common/html/knife_cookbook.html +486 -486
  74. data/distro/common/html/knife_data_bag.html +373 -373
  75. data/distro/common/html/knife_delete.html +92 -92
  76. data/distro/common/html/knife_deps.html +142 -142
  77. data/distro/common/html/knife_diff.html +122 -122
  78. data/distro/common/html/knife_download.html +144 -144
  79. data/distro/common/html/knife_edit.html +88 -88
  80. data/distro/common/html/knife_environment.html +325 -325
  81. data/distro/common/html/knife_exec.html +219 -219
  82. data/distro/common/html/knife_index_rebuild.html +82 -82
  83. data/distro/common/html/knife_list.html +113 -113
  84. data/distro/common/html/knife_node.html +457 -457
  85. data/distro/common/html/knife_raw.html +109 -109
  86. data/distro/common/html/knife_recipe_list.html +90 -90
  87. data/distro/common/html/knife_role.html +294 -294
  88. data/distro/common/html/knife_search.html +202 -202
  89. data/distro/common/html/knife_serve.html +78 -78
  90. data/distro/common/html/knife_show.html +103 -103
  91. data/distro/common/html/knife_ssh.html +176 -176
  92. data/distro/common/html/knife_ssl_check.html +150 -150
  93. data/distro/common/html/knife_ssl_fetch.html +150 -150
  94. data/distro/common/html/knife_status.html +143 -143
  95. data/distro/common/html/knife_tag.html +137 -137
  96. data/distro/common/html/knife_upload.html +152 -152
  97. data/distro/common/html/knife_user.html +241 -241
  98. data/distro/common/html/knife_using.html +209 -209
  99. data/distro/common/html/knife_xargs.html +121 -121
  100. data/distro/common/html/search.html +81 -81
  101. data/distro/common/man/man1/README.md +58 -58
  102. data/distro/common/man/man1/chef-shell.1 +194 -194
  103. data/distro/common/man/man1/knife-bootstrap.1 +215 -215
  104. data/distro/common/man/man1/knife-client.1 +443 -443
  105. data/distro/common/man/man1/knife-configure.1 +161 -161
  106. data/distro/common/man/man1/knife-cookbook.1 +770 -770
  107. data/distro/common/man/man1/knife-data-bag.1 +617 -617
  108. data/distro/common/man/man1/knife-delete.1 +127 -127
  109. data/distro/common/man/man1/knife-deps.1 +246 -246
  110. data/distro/common/man/man1/knife-diff.1 +226 -226
  111. data/distro/common/man/man1/knife-download.1 +258 -258
  112. data/distro/common/man/man1/knife-edit.1 +121 -121
  113. data/distro/common/man/man1/knife-environment.1 +508 -508
  114. data/distro/common/man/man1/knife-exec.1 +362 -362
  115. data/distro/common/man/man1/knife-index-rebuild.1 +63 -63
  116. data/distro/common/man/man1/knife-list.1 +174 -174
  117. data/distro/common/man/man1/knife-node.1 +716 -716
  118. data/distro/common/man/man1/knife-raw.1 +172 -172
  119. data/distro/common/man/man1/knife-recipe-list.1 +85 -85
  120. data/distro/common/man/man1/knife-role.1 +426 -426
  121. data/distro/common/man/man1/knife-search.1 +359 -359
  122. data/distro/common/man/man1/knife-serve.1 +109 -109
  123. data/distro/common/man/man1/knife-show.1 +160 -160
  124. data/distro/common/man/man1/knife-ssh.1 +284 -284
  125. data/distro/common/man/man1/knife-ssl-check.1 +207 -207
  126. data/distro/common/man/man1/knife-ssl-fetch.1 +207 -207
  127. data/distro/common/man/man1/knife-status.1 +234 -234
  128. data/distro/common/man/man1/knife-tag.1 +189 -189
  129. data/distro/common/man/man1/knife-upload.1 +280 -280
  130. data/distro/common/man/man1/knife-user.1 +356 -356
  131. data/distro/common/man/man1/knife-xargs.1 +189 -189
  132. data/distro/common/man/man1/knife.1 +332 -332
  133. data/distro/common/man/man8/chef-apply.8 +86 -86
  134. data/distro/common/man/man8/chef-client.8 +398 -398
  135. data/distro/common/man/man8/chef-solo.8 +260 -260
  136. data/distro/common/markdown/README +3 -3
  137. data/lib/chef/application.rb +23 -0
  138. data/lib/chef/application/client.rb +10 -2
  139. data/lib/chef/application/knife.rb +8 -0
  140. data/lib/chef/application/solo.rb +10 -2
  141. data/lib/chef/audit/audit_reporter.rb +5 -1
  142. data/lib/chef/audit/runner.rb +1 -1
  143. data/lib/chef/chef_fs/chef_fs_data_store.rb +1 -0
  144. data/lib/chef/chef_fs/file_system/repository/acls_dir.rb +4 -2
  145. data/lib/chef/chef_fs/file_system/repository/base_file.rb +3 -0
  146. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_cookbook_entry.rb +1 -0
  147. data/lib/chef/chef_fs/file_system/repository/directory.rb +12 -1
  148. data/lib/chef/chef_fs/file_system_cache.rb +80 -0
  149. data/lib/chef/data_collector.rb +18 -1
  150. data/lib/chef/data_collector/resource_report.rb +1 -0
  151. data/lib/chef/decorator/unchain.rb +16 -0
  152. data/lib/chef/dsl/cheffish.rb +1 -0
  153. data/lib/chef/dsl/declare_resource.rb +9 -1
  154. data/lib/chef/file_access_control/windows.rb +3 -3
  155. data/lib/chef/knife/bootstrap.rb +9 -0
  156. data/lib/chef/knife/cookbook_site_install.rb +2 -11
  157. data/lib/chef/knife/cookbook_site_share.rb +7 -13
  158. data/lib/chef/knife/core/bootstrap_context.rb +10 -0
  159. data/lib/chef/knife/help_topics.rb +4 -4
  160. data/lib/chef/nil_argument.rb +3 -3
  161. data/lib/chef/node/attribute.rb +2 -2
  162. data/lib/chef/provider/apt_repository.rb +1 -1
  163. data/lib/chef/provider/apt_update.rb +12 -3
  164. data/lib/chef/provider/cron.rb +1 -1
  165. data/lib/chef/provider/package/aix.rb +5 -1
  166. data/lib/chef/provider/package/zypper.rb +7 -7
  167. data/lib/chef/provider/resource_update.rb +52 -52
  168. data/lib/chef/reserved_names.rb +9 -9
  169. data/lib/chef/resource.rb +13 -1
  170. data/lib/chef/resource/freebsd_package.rb +1 -1
  171. data/lib/chef/run_context.rb +15 -42
  172. data/lib/chef/sandbox.rb +20 -20
  173. data/lib/chef/version.rb +1 -1
  174. data/lib/chef/version_class.rb +7 -2
  175. data/lib/chef/win32/file.rb +4 -4
  176. data/lib/chef/win32/system.rb +0 -0
  177. data/spec/data/apt/chef-integration-test-1.0/debian/changelog +5 -5
  178. data/spec/data/apt/chef-integration-test-1.0/debian/compat +1 -1
  179. data/spec/data/apt/chef-integration-test-1.0/debian/control +13 -13
  180. data/spec/data/apt/chef-integration-test-1.0/debian/files +1 -1
  181. data/spec/data/apt/chef-integration-test-1.0/debian/rules +13 -13
  182. data/spec/data/apt/chef-integration-test-1.0/debian/source/format +1 -1
  183. data/spec/data/apt/chef-integration-test-1.1/debian/changelog +11 -11
  184. data/spec/data/apt/chef-integration-test-1.1/debian/compat +1 -1
  185. data/spec/data/apt/chef-integration-test-1.1/debian/control +13 -13
  186. data/spec/data/apt/chef-integration-test-1.1/debian/files +1 -1
  187. data/spec/data/apt/chef-integration-test-1.1/debian/rules +13 -13
  188. data/spec/data/apt/chef-integration-test-1.1/debian/source/format +1 -1
  189. data/spec/data/apt/chef-integration-test2-1.0/debian/rules +0 -0
  190. data/spec/data/apt/chef-integration-test_1.0-1_amd64.changes +22 -22
  191. data/spec/data/apt/chef-integration-test_1.1-1_amd64.changes +22 -22
  192. data/spec/data/apt/var/www/apt/conf/distributions +7 -7
  193. data/spec/data/apt/var/www/apt/conf/incoming +4 -4
  194. data/spec/data/apt/var/www/apt/conf/pulls +3 -3
  195. data/spec/data/apt/var/www/apt/db/version +4 -4
  196. data/spec/data/apt/var/www/apt/dists/sid/Release +19 -19
  197. data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Packages +16 -16
  198. data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Release +5 -5
  199. data/spec/data/bootstrap/encrypted_data_bag_secret +1 -1
  200. data/spec/data/bootstrap/no_proxy.erb +2 -2
  201. data/spec/data/bootstrap/secret.erb +9 -9
  202. data/spec/data/bootstrap/test-hints.erb +12 -12
  203. data/spec/data/bootstrap/test.erb +1 -1
  204. data/spec/data/cb_version_cookbooks/tatft/README.rdoc +2 -2
  205. data/spec/data/cb_version_cookbooks/tatft/attributes/default.rb +1 -1
  206. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-600hhz-0 +1 -1
  207. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ahd2gq-0 +1 -1
  208. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-api8ux-0 +1 -1
  209. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-b0r1m1-0 +1 -1
  210. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-bfygsi-0 +1 -1
  211. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-el14l6-0 +1 -1
  212. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ivrl3y-0 +1 -1
  213. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-kkbs85-0 +1 -1
  214. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ory1ux-0 +1 -1
  215. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-pgsq76-0 +1 -1
  216. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ra8uim-0 +1 -1
  217. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-t7k1g-0 +1 -1
  218. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-t8g0sv-0 +1 -1
  219. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ufy6g3-0 +1 -1
  220. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-x2d6j9-0 +1 -1
  221. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-xi0l6h-0 +1 -1
  222. data/spec/data/config.rb +6 -6
  223. data/spec/data/cookbooks/angrybash/metadata.rb +2 -2
  224. data/spec/data/cookbooks/angrybash/recipes/default.rb +8 -8
  225. data/spec/data/cookbooks/apache2/files/default/apache2_module_conf_generate.pl +2 -2
  226. data/spec/data/cookbooks/apache2/metadata.rb +2 -2
  227. data/spec/data/cookbooks/apache2/recipes/default.rb +2 -2
  228. data/spec/data/cookbooks/borken/metadata.rb +2 -2
  229. data/spec/data/cookbooks/borken/recipes/default.rb +1 -1
  230. data/spec/data/cookbooks/borken/templates/default/borken.erb +1 -1
  231. data/spec/data/cookbooks/chefignore +8 -8
  232. data/spec/data/cookbooks/ignorken/files/default/not_me.rb +2 -2
  233. data/spec/data/cookbooks/ignorken/metadata.rb +2 -2
  234. data/spec/data/cookbooks/ignorken/recipes/ignoreme.rb +1 -1
  235. data/spec/data/cookbooks/ignorken/templates/ubuntu-12.10/not_me.rb +2 -2
  236. data/spec/data/cookbooks/java/files/default/java.response +1 -1
  237. data/spec/data/cookbooks/java/metadata.rb +2 -2
  238. data/spec/data/cookbooks/name-mismatch-versionnumber/README.md +4 -4
  239. data/spec/data/cookbooks/name-mismatch-versionnumber/metadata.rb +8 -8
  240. data/spec/data/cookbooks/openldap/attributes/default.rb +16 -16
  241. data/spec/data/cookbooks/openldap/attributes/smokey.rb +1 -1
  242. data/spec/data/cookbooks/openldap/definitions/client.rb +5 -5
  243. data/spec/data/cookbooks/openldap/definitions/server.rb +5 -5
  244. data/spec/data/cookbooks/openldap/files/default/.dotfile +1 -1
  245. data/spec/data/cookbooks/openldap/files/default/remotedir/.a_dotdir/.a_dotfile_in_a_dotdir +1 -1
  246. data/spec/data/cookbooks/openldap/files/default/remotedir/not_a_template.erb +2 -2
  247. data/spec/data/cookbooks/openldap/files/default/remotedir/remote_dir_file1.txt +2 -2
  248. data/spec/data/cookbooks/openldap/files/default/remotedir/remote_dir_file2.txt +2 -2
  249. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/.a_dotfile +1 -1
  250. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/remote_subdir_file1.txt +2 -2
  251. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/remote_subdir_file2.txt +2 -2
  252. data/spec/data/cookbooks/openldap/files/default/remotedir/subdir_with_no_file_just_a_subsubdir/the_subsubdir/some_file.txt +3 -3
  253. data/spec/data/cookbooks/openldap/libraries/openldap.rb +4 -4
  254. data/spec/data/cookbooks/openldap/libraries/openldap/version.rb +3 -3
  255. data/spec/data/cookbooks/openldap/metadata.rb +8 -8
  256. data/spec/data/cookbooks/openldap/recipes/default.rb +4 -4
  257. data/spec/data/cookbooks/openldap/recipes/gigantor.rb +3 -3
  258. data/spec/data/cookbooks/openldap/recipes/one.rb +15 -15
  259. data/spec/data/cookbooks/openldap/recipes/return.rb +2 -2
  260. data/spec/data/cookbooks/openldap/templates/default/helper_test.erb +1 -1
  261. data/spec/data/cookbooks/openldap/templates/default/helpers_via_partial_test.erb +1 -1
  262. data/spec/data/cookbooks/openldap/templates/default/no_windows_line_endings.erb +4 -4
  263. data/spec/data/cookbooks/openldap/templates/default/openldap_variable_stuff.conf.erb +1 -1
  264. data/spec/data/cookbooks/openldap/templates/default/test.erb +1 -1
  265. data/spec/data/cookbooks/preseed/files/default/preseed-file.seed +1 -1
  266. data/spec/data/cookbooks/preseed/files/default/preseed-template.seed +4 -4
  267. data/spec/data/cookbooks/preseed/metadata.rb +2 -2
  268. data/spec/data/cookbooks/preseed/templates/default/preseed-template-variables.seed +1 -1
  269. data/spec/data/cookbooks/preseed/templates/default/preseed-template.seed +1 -1
  270. data/spec/data/definitions/test.rb +4 -4
  271. data/spec/data/environment-config.rb +4 -4
  272. data/spec/data/file-providers-method-snapshot-chef-11-4.json +127 -127
  273. data/spec/data/fileedit/hosts +4 -4
  274. data/spec/data/incomplete-metadata-chef-repo/incomplete-metadata/README.md +4 -4
  275. data/spec/data/incomplete-metadata-chef-repo/incomplete-metadata/metadata.rb +13 -13
  276. data/spec/data/invalid-metadata-chef-repo/invalid-metadata/README.md +4 -4
  277. data/spec/data/kitchen/chefignore +6 -6
  278. data/spec/data/kitchen/openldap/attributes/default.rb +3 -3
  279. data/spec/data/kitchen/openldap/attributes/robinson.rb +2 -2
  280. data/spec/data/kitchen/openldap/definitions/client.rb +3 -3
  281. data/spec/data/kitchen/openldap/definitions/drewbarrymore.rb +2 -2
  282. data/spec/data/kitchen/openldap/recipes/gigantor.rb +2 -2
  283. data/spec/data/kitchen/openldap/recipes/ignoreme.rb +2 -2
  284. data/spec/data/kitchen/openldap/recipes/woot.rb +3 -3
  285. data/spec/data/knife_subcommand/test_explicit_category.rb +6 -6
  286. data/spec/data/knife_subcommand/test_name_mapping.rb +4 -4
  287. data/spec/data/knife_subcommand/test_yourself.rb +21 -21
  288. data/spec/data/lwrp/providers/inline_compiler.rb +26 -26
  289. data/spec/data/lwrp/providers/monkey_name_printer.rb +5 -5
  290. data/spec/data/lwrp/providers/paint_drying_watcher.rb +7 -7
  291. data/spec/data/lwrp/providers/thumb_twiddler.rb +7 -7
  292. data/spec/data/lwrp/resources/foo.rb +4 -4
  293. data/spec/data/lwrp/resources_with_default_attributes/nodeattr.rb +1 -1
  294. data/spec/data/lwrp_override/providers/buck_passer.rb +5 -5
  295. data/spec/data/mac_users/10.7-8.plist.xml +559 -559
  296. data/spec/data/mac_users/10.7-8.shadow.xml +11 -11
  297. data/spec/data/mac_users/10.7.plist.xml +559 -559
  298. data/spec/data/mac_users/10.7.shadow.xml +11 -11
  299. data/spec/data/mac_users/10.8.plist.xml +559 -559
  300. data/spec/data/mac_users/10.8.shadow.xml +21 -21
  301. data/spec/data/mac_users/10.9.plist.xml +560 -560
  302. data/spec/data/mac_users/10.9.shadow.xml +21 -21
  303. data/spec/data/metadata/quick_start/metadata.rb +19 -19
  304. data/spec/data/nodes/default.rb +15 -15
  305. data/spec/data/nodes/test.example.com.rb +17 -17
  306. data/spec/data/nodes/test.rb +15 -15
  307. data/spec/data/null_config.rb +1 -1
  308. data/spec/data/object_loader/environments/test.json +7 -7
  309. data/spec/data/object_loader/environments/test.rb +2 -2
  310. data/spec/data/object_loader/environments/test_json_class.json +8 -8
  311. data/spec/data/object_loader/nodes/test.json +7 -7
  312. data/spec/data/object_loader/nodes/test.rb +2 -2
  313. data/spec/data/object_loader/nodes/test_json_class.json +8 -8
  314. data/spec/data/object_loader/roles/test.json +7 -7
  315. data/spec/data/object_loader/roles/test.rb +2 -2
  316. data/spec/data/object_loader/roles/test_json_class.json +8 -8
  317. data/spec/data/partial_one.erb +1 -1
  318. data/spec/data/recipes/test.rb +7 -7
  319. data/spec/data/run_context/cookbooks/circular-dep1/definitions/circular_dep1_res.rb +1 -1
  320. data/spec/data/run_context/cookbooks/circular-dep1/libraries/lib.rb +2 -2
  321. data/spec/data/run_context/cookbooks/circular-dep1/metadata.rb +2 -2
  322. data/spec/data/run_context/cookbooks/circular-dep1/providers/provider.rb +1 -1
  323. data/spec/data/run_context/cookbooks/circular-dep1/resources/resource.rb +1 -1
  324. data/spec/data/run_context/cookbooks/circular-dep2/definitions/circular_dep2_res.rb +1 -1
  325. data/spec/data/run_context/cookbooks/circular-dep2/libraries/lib.rb +2 -2
  326. data/spec/data/run_context/cookbooks/circular-dep2/metadata.rb +2 -2
  327. data/spec/data/run_context/cookbooks/circular-dep2/providers/provider.rb +1 -1
  328. data/spec/data/run_context/cookbooks/circular-dep2/resources/resource.rb +1 -1
  329. data/spec/data/run_context/cookbooks/dependency1/definitions/dependency1_res.rb +1 -1
  330. data/spec/data/run_context/cookbooks/dependency1/libraries/lib.rb +2 -2
  331. data/spec/data/run_context/cookbooks/dependency1/providers/provider.rb +1 -1
  332. data/spec/data/run_context/cookbooks/dependency1/resources/resource.rb +1 -1
  333. data/spec/data/run_context/cookbooks/dependency2/definitions/dependency2_res.rb +1 -1
  334. data/spec/data/run_context/cookbooks/dependency2/libraries/lib.rb +2 -2
  335. data/spec/data/run_context/cookbooks/dependency2/providers/provider.rb +1 -1
  336. data/spec/data/run_context/cookbooks/dependency2/resources/resource.rb +1 -1
  337. data/spec/data/run_context/cookbooks/no-default-attr/definitions/no_default-attr_res.rb +1 -1
  338. data/spec/data/run_context/cookbooks/no-default-attr/providers/provider.rb +1 -1
  339. data/spec/data/run_context/cookbooks/no-default-attr/resources/resource.rb +1 -1
  340. data/spec/data/run_context/cookbooks/test-with-circular-deps/definitions/test_with-circular-deps_res.rb +1 -1
  341. data/spec/data/run_context/cookbooks/test-with-circular-deps/libraries/lib.rb +2 -2
  342. data/spec/data/run_context/cookbooks/test-with-circular-deps/metadata.rb +2 -2
  343. data/spec/data/run_context/cookbooks/test-with-circular-deps/providers/provider.rb +1 -1
  344. data/spec/data/run_context/cookbooks/test-with-circular-deps/resources/resource.rb +1 -1
  345. data/spec/data/run_context/cookbooks/test-with-deps/definitions/test_with-deps_res.rb +1 -1
  346. data/spec/data/run_context/cookbooks/test-with-deps/libraries/lib.rb +1 -1
  347. data/spec/data/run_context/cookbooks/test-with-deps/metadata.rb +3 -3
  348. data/spec/data/run_context/cookbooks/test-with-deps/providers/provider.rb +1 -1
  349. data/spec/data/run_context/cookbooks/test-with-deps/resources/resource.rb +1 -1
  350. data/spec/data/run_context/cookbooks/test/attributes/george.rb +1 -1
  351. data/spec/data/run_context/cookbooks/test/definitions/new_animals.rb +9 -9
  352. data/spec/data/run_context/cookbooks/test/definitions/new_cat.rb +5 -5
  353. data/spec/data/run_context/cookbooks/test/definitions/test_res.rb +1 -1
  354. data/spec/data/run_context/cookbooks/test/providers/provider.rb +1 -1
  355. data/spec/data/run_context/cookbooks/test/recipes/default.rb +5 -5
  356. data/spec/data/run_context/cookbooks/test/recipes/one.rb +7 -7
  357. data/spec/data/run_context/cookbooks/test/recipes/two.rb +7 -7
  358. data/spec/data/run_context/cookbooks/test/resources/resource.rb +1 -1
  359. data/spec/data/run_context/nodes/run_context.rb +5 -5
  360. data/spec/data/search_queries_to_transform.txt +98 -98
  361. data/spec/data/shef-config.rb +10 -10
  362. data/spec/data/ssl/5e707473.0 +18 -18
  363. data/spec/data/ssl/chef-rspec.cert +27 -27
  364. data/spec/data/ssl/chef-rspec.key +27 -27
  365. data/spec/data/ssl/key.pem +15 -15
  366. data/spec/data/ssl/private_key.pem +27 -27
  367. data/spec/data/ssl/private_key_with_whitespace.pem +32 -32
  368. data/spec/data/standalone_cookbook/chefignore +9 -9
  369. data/spec/data/standalone_cookbook/recipes/default.rb +2 -2
  370. data/spec/data/trusted_certs/example.crt +22 -22
  371. data/spec/data/trusted_certs/intermediate.pem +27 -27
  372. data/spec/data/trusted_certs/root.pem +22 -22
  373. data/spec/functional/assets/chefinittest +34 -34
  374. data/spec/functional/assets/testchefsubsys +10 -10
  375. data/spec/functional/mixin/powershell_out_spec.rb +2 -2
  376. data/spec/functional/provider/remote_file/cache_control_data_spec.rb +0 -0
  377. data/spec/functional/resource/aix_service_spec.rb +0 -0
  378. data/spec/functional/resource/aixinit_service_spec.rb +0 -0
  379. data/spec/functional/resource/cron_spec.rb +8 -1
  380. data/spec/functional/resource/env_spec.rb +0 -0
  381. data/spec/functional/resource/link_spec.rb +1 -6
  382. data/spec/functional/run_lock_spec.rb +17 -10
  383. data/spec/integration/knife/diff_spec.rb +2 -2
  384. data/spec/integration/knife/download_spec.rb +4 -4
  385. data/spec/integration/knife/raw_spec.rb +2 -0
  386. data/spec/integration/knife/upload_spec.rb +3 -3
  387. data/spec/rcov.opts +2 -2
  388. data/spec/spec_helper.rb +11 -1
  389. data/spec/support/shared/integration/knife_support.rb +4 -0
  390. data/spec/unit/application/client_spec.rb +35 -0
  391. data/spec/unit/application/solo_spec.rb +6 -6
  392. data/spec/unit/chef_fs/file_system/repository/directory_spec.rb +1 -0
  393. data/spec/unit/data_collector_spec.rb +41 -1
  394. data/spec/unit/dsl/declare_resource_spec.rb +30 -0
  395. data/spec/unit/knife/cookbook_site_install_spec.rb +2 -0
  396. data/spec/unit/knife/cookbook_site_share_spec.rb +4 -4
  397. data/spec/unit/node_spec.rb +6 -0
  398. data/spec/unit/provider/cron_spec.rb +16 -16
  399. data/spec/unit/provider/package/aix_spec.rb +13 -0
  400. data/spec/unit/provider/package/zypper_spec.rb +18 -2
  401. data/spec/unit/resource/apt_repository_spec.rb +14 -2
  402. data/spec/unit/resource/apt_update_spec.rb +14 -2
  403. data/spec/unit/resource_builder_spec.rb +1 -1
  404. data/tasks/bin/bundle-platform +0 -0
  405. data/tasks/bin/bundle-platform.bat +0 -0
  406. data/tasks/bin/create-override-gemfile +0 -0
  407. data/tasks/bin/run_external_test +0 -0
  408. data/tasks/bundle.rb +2 -2
  409. metadata +29 -15
  410. data/acceptance/data-collector/Berksfile.lock +0 -6
@@ -1,189 +1,189 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE-XARGS" "1" "Chef 12.0" "" "knife xargs"
4
- .SH NAME
5
- knife-xargs \- The man page for the knife xargs 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 xargs\fP subcommand is used to take patterns from standard input, download as JSON, run a command against the downloaded JSON, and then upload any changes.
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 xargs [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\-0\fP
56
- Use to show a \fBNULL\fP character (\fB\e0\fP) instead of white space as the separator. Default: \fBfalse\fP\&.
57
- .TP
58
- .B \fB\-\-chef\-repo\-path PATH\fP
59
- 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.
60
- .TP
61
- .B \fB\-\-concurrency\fP
62
- The number of allowed concurrent connections. Default: \fB10\fP\&.
63
- .TP
64
- .B \fB\-\-[no\-]diff\fP
65
- Use to show a diff when a file changes. Default: \fB\-\-diff\fP\&.
66
- .TP
67
- .B \fB\-\-dry\-run\fP
68
- Use to prevent changes from being uploaded to the Chef server\&. Default: \fBfalse\fP\&.
69
- .TP
70
- .B \fB\-\-[no\-]force\fP
71
- Use to force the upload of files even if they haven\(aqt been changed. Default: \fB\-\-no\-force\fP\&.
72
- .TP
73
- .B \fB\-I REPLACE_STRING\fP, \fB\-\-replace REPLACE_STRING\fP
74
- Use to define a string that will be used to replace all occurrences of a file name. Default: \fBnil\fP\&.
75
- .TP
76
- .B \fB\-J REPLACE_STRING\fP, \fB\-\-replace\-first REPLACE_STRING\fP
77
- Use to define a string that will be used to replace the first occurrence of a file name. Default: \fBnil\fP\&.
78
- .TP
79
- .B \fB\-\-local\fP
80
- Use to build or execute a command line against a local file. Set to \fBfalse\fP to build or execute against a remote file. Default: \fBfalse\fP\&.
81
- .TP
82
- .B \fB\-n MAX_ARGS\fP, \fB\-\-max\-args MAX_ARGS\fP
83
- The maximum number of arguments per command line. Default: \fBnil\fP\&.
84
- .TP
85
- .B \fB\-p [PATTERN...]\fP, \fB\-\-pattern [PATTERN...]\fP
86
- One (or more) patterns for a command line. If this option is not specified, a list of patterns may be expected on standard input. Default: \fBnil\fP\&.
87
- .TP
88
- .B \fB\-\-repo\-mode MODE\fP
89
- 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 value: \fBdefault\fP\&.
90
- .TP
91
- .B \fB\-s LENGTH\fP, \fB\-\-max\-chars LENGTH\fP
92
- The maximum size (in characters) for a command line. Default: \fBnil\fP\&.
93
- .TP
94
- .B \fB\-t\fP
95
- Use to run the print command on the command line. Default: \fBnil\fP\&.
96
- .TP
97
- .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
98
- The configuration file to use.
99
- .TP
100
- .B \fB\-\-chef\-zero\-port PORT\fP
101
- The port on which chef\-zero will listen.
102
- .TP
103
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
104
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
105
- .TP
106
- .B \fB\-\-defaults\fP
107
- Use to have knife use the default value instead of asking a user to provide one.
108
- .TP
109
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
110
- The $EDITOR that is used for all interactive commands.
111
- .TP
112
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
113
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
114
- .TP
115
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
116
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
117
- .TP
118
- .B \fB\-h\fP, \fB\-\-help\fP
119
- Shows help for the command.
120
- .TP
121
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
122
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
123
- .TP
124
- .B \fB\-\-[no\-]color\fP
125
- Use to view colored output.
126
- .TP
127
- .B \fB\-\-print\-after\fP
128
- Use to show data after a destructive operation.
129
- .TP
130
- .B \fB\-\-server\-url URL\fP
131
- The URL for the Chef server\&.
132
- .TP
133
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
134
- 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.
135
- .TP
136
- .B \fB\-v\fP, \fB\-\-version\fP
137
- The version of the chef\-client\&.
138
- .TP
139
- .B \fB\-V\fP, \fB\-\-verbose\fP
140
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
141
- .TP
142
- .B \fB\-y\fP, \fB\-\-yes\fP
143
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
144
- .TP
145
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
146
- 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\&.
147
- .UNINDENT
148
- .sp
149
- \fBExamples\fP
150
- .sp
151
- The following examples show various ways of listing all nodes on the server, and then using Perl to replace \fBgrantmc\fP with \fBgmc\fP:
152
- .INDENT 0.0
153
- .INDENT 3.5
154
- .sp
155
- .nf
156
- .ft C
157
- $ knife list \(aqnodes/*\(aq | knife xargs "perl \-i \-pe \(aqs/grantmc/gmc\(aq"
158
- .ft P
159
- .fi
160
- .UNINDENT
161
- .UNINDENT
162
- .sp
163
- or without quotes and the backslash escaped:
164
- .INDENT 0.0
165
- .INDENT 3.5
166
- .sp
167
- .nf
168
- .ft C
169
- $ knife list /nodes/\e* | knife xargs "perl \-i \-pe \(aqs/grantmc/gmc\(aq"
170
- .ft P
171
- .fi
172
- .UNINDENT
173
- .UNINDENT
174
- .sp
175
- or by using the \fB\-\-pattern\fP option:
176
- .INDENT 0.0
177
- .INDENT 3.5
178
- .sp
179
- .nf
180
- .ft C
181
- $ knife xargs \-\-pattern \(aq/nodes.*\(aq "perl \-i \-pe \(aqs/grantmc/gmc\(aq"
182
- .ft P
183
- .fi
184
- .UNINDENT
185
- .UNINDENT
186
- .SH AUTHOR
187
- Chef
188
- .\" Generated by docutils manpage writer.
189
- .
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-XARGS" "1" "Chef 12.0" "" "knife xargs"
4
+ .SH NAME
5
+ knife-xargs \- The man page for the knife xargs 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 xargs\fP subcommand is used to take patterns from standard input, download as JSON, run a command against the downloaded JSON, and then upload any changes.
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 xargs [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\-0\fP
56
+ Use to show a \fBNULL\fP character (\fB\e0\fP) instead of white space as the separator. Default: \fBfalse\fP\&.
57
+ .TP
58
+ .B \fB\-\-chef\-repo\-path PATH\fP
59
+ 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.
60
+ .TP
61
+ .B \fB\-\-concurrency\fP
62
+ The number of allowed concurrent connections. Default: \fB10\fP\&.
63
+ .TP
64
+ .B \fB\-\-[no\-]diff\fP
65
+ Use to show a diff when a file changes. Default: \fB\-\-diff\fP\&.
66
+ .TP
67
+ .B \fB\-\-dry\-run\fP
68
+ Use to prevent changes from being uploaded to the Chef server\&. Default: \fBfalse\fP\&.
69
+ .TP
70
+ .B \fB\-\-[no\-]force\fP
71
+ Use to force the upload of files even if they haven\(aqt been changed. Default: \fB\-\-no\-force\fP\&.
72
+ .TP
73
+ .B \fB\-I REPLACE_STRING\fP, \fB\-\-replace REPLACE_STRING\fP
74
+ Use to define a string that will be used to replace all occurrences of a file name. Default: \fBnil\fP\&.
75
+ .TP
76
+ .B \fB\-J REPLACE_STRING\fP, \fB\-\-replace\-first REPLACE_STRING\fP
77
+ Use to define a string that will be used to replace the first occurrence of a file name. Default: \fBnil\fP\&.
78
+ .TP
79
+ .B \fB\-\-local\fP
80
+ Use to build or execute a command line against a local file. Set to \fBfalse\fP to build or execute against a remote file. Default: \fBfalse\fP\&.
81
+ .TP
82
+ .B \fB\-n MAX_ARGS\fP, \fB\-\-max\-args MAX_ARGS\fP
83
+ The maximum number of arguments per command line. Default: \fBnil\fP\&.
84
+ .TP
85
+ .B \fB\-p [PATTERN...]\fP, \fB\-\-pattern [PATTERN...]\fP
86
+ One (or more) patterns for a command line. If this option is not specified, a list of patterns may be expected on standard input. Default: \fBnil\fP\&.
87
+ .TP
88
+ .B \fB\-\-repo\-mode MODE\fP
89
+ 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 value: \fBdefault\fP\&.
90
+ .TP
91
+ .B \fB\-s LENGTH\fP, \fB\-\-max\-chars LENGTH\fP
92
+ The maximum size (in characters) for a command line. Default: \fBnil\fP\&.
93
+ .TP
94
+ .B \fB\-t\fP
95
+ Use to run the print command on the command line. Default: \fBnil\fP\&.
96
+ .TP
97
+ .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
98
+ The configuration file to use.
99
+ .TP
100
+ .B \fB\-\-chef\-zero\-port PORT\fP
101
+ The port on which chef\-zero will listen.
102
+ .TP
103
+ .B \fB\-d\fP, \fB\-\-disable\-editing\fP
104
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
105
+ .TP
106
+ .B \fB\-\-defaults\fP
107
+ Use to have knife use the default value instead of asking a user to provide one.
108
+ .TP
109
+ .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
110
+ The $EDITOR that is used for all interactive commands.
111
+ .TP
112
+ .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
113
+ The name of the environment. When this option is added to a command, the command will run only against the named environment.
114
+ .TP
115
+ .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
116
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
117
+ .TP
118
+ .B \fB\-h\fP, \fB\-\-help\fP
119
+ Shows help for the command.
120
+ .TP
121
+ .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
122
+ The private key that knife will use to sign requests made by the API client to the Chef server\&.
123
+ .TP
124
+ .B \fB\-\-[no\-]color\fP
125
+ Use to view colored output.
126
+ .TP
127
+ .B \fB\-\-print\-after\fP
128
+ Use to show data after a destructive operation.
129
+ .TP
130
+ .B \fB\-\-server\-url URL\fP
131
+ The URL for the Chef server\&.
132
+ .TP
133
+ .B \fB\-u USER\fP, \fB\-\-user USER\fP
134
+ 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.
135
+ .TP
136
+ .B \fB\-v\fP, \fB\-\-version\fP
137
+ The version of the chef\-client\&.
138
+ .TP
139
+ .B \fB\-V\fP, \fB\-\-verbose\fP
140
+ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
141
+ .TP
142
+ .B \fB\-y\fP, \fB\-\-yes\fP
143
+ Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
144
+ .TP
145
+ .B \fB\-z\fP, \fB\-\-local\-mode\fP
146
+ 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\&.
147
+ .UNINDENT
148
+ .sp
149
+ \fBExamples\fP
150
+ .sp
151
+ The following examples show various ways of listing all nodes on the server, and then using Perl to replace \fBgrantmc\fP with \fBgmc\fP:
152
+ .INDENT 0.0
153
+ .INDENT 3.5
154
+ .sp
155
+ .nf
156
+ .ft C
157
+ $ knife list \(aqnodes/*\(aq | knife xargs "perl \-i \-pe \(aqs/grantmc/gmc\(aq"
158
+ .ft P
159
+ .fi
160
+ .UNINDENT
161
+ .UNINDENT
162
+ .sp
163
+ or without quotes and the backslash escaped:
164
+ .INDENT 0.0
165
+ .INDENT 3.5
166
+ .sp
167
+ .nf
168
+ .ft C
169
+ $ knife list /nodes/\e* | knife xargs "perl \-i \-pe \(aqs/grantmc/gmc\(aq"
170
+ .ft P
171
+ .fi
172
+ .UNINDENT
173
+ .UNINDENT
174
+ .sp
175
+ or by using the \fB\-\-pattern\fP option:
176
+ .INDENT 0.0
177
+ .INDENT 3.5
178
+ .sp
179
+ .nf
180
+ .ft C
181
+ $ knife xargs \-\-pattern \(aq/nodes.*\(aq "perl \-i \-pe \(aqs/grantmc/gmc\(aq"
182
+ .ft P
183
+ .fi
184
+ .UNINDENT
185
+ .UNINDENT
186
+ .SH AUTHOR
187
+ Chef
188
+ .\" Generated by docutils manpage writer.
189
+ .
@@ -1,332 +1,332 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE" "1" "Chef 12.0" "" "knife"
4
- .SH NAME
5
- knife \- The man page for the knife command line tool.
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
- knife is a command\-line tool that provides an interface between a local chef\-repo and the Chef server\&. knife helps users to manage:
35
- .INDENT 0.0
36
- .IP \(bu 2
37
- Nodes
38
- .IP \(bu 2
39
- Cookbooks and recipes
40
- .IP \(bu 2
41
- Roles
42
- .IP \(bu 2
43
- Stores of JSON data (data bags), including encrypted data
44
- .IP \(bu 2
45
- Environments
46
- .IP \(bu 2
47
- Cloud resources, including provisioning
48
- .IP \(bu 2
49
- The installation of the chef\-client on management workstations
50
- .IP \(bu 2
51
- Searching of indexed data on the Chef server
52
- .UNINDENT
53
- .sp
54
- Knife subcommands:
55
- .INDENT 0.0
56
- .IP \(bu 2
57
- knife bootstrap
58
- .IP \(bu 2
59
- knife client
60
- .IP \(bu 2
61
- knife configure
62
- .IP \(bu 2
63
- knife cookbook
64
- .IP \(bu 2
65
- knife cookbook site
66
- .IP \(bu 2
67
- knife data bag
68
- .IP \(bu 2
69
- knife delete
70
- .IP \(bu 2
71
- knife deps
72
- .IP \(bu 2
73
- knife diff
74
- .IP \(bu 2
75
- knife download
76
- .IP \(bu 2
77
- knife edit
78
- .IP \(bu 2
79
- knife environment
80
- .IP \(bu 2
81
- knife exec
82
- .IP \(bu 2
83
- knife list
84
- .IP \(bu 2
85
- knife node
86
- .IP \(bu 2
87
- knife raw
88
- .IP \(bu 2
89
- knife recipe list
90
- .IP \(bu 2
91
- knife role
92
- .IP \(bu 2
93
- knife search
94
- .IP \(bu 2
95
- knife show
96
- .IP \(bu 2
97
- knife ssh
98
- .IP \(bu 2
99
- knife status
100
- .IP \(bu 2
101
- knife tag
102
- .IP \(bu 2
103
- knife upload
104
- .IP \(bu 2
105
- knife user
106
- .IP \(bu 2
107
- knife xargs
108
- .UNINDENT
109
- .SH WORKING WITH KNIFE
110
- .sp
111
- knife runs from a management workstation and sits in\-between a Chef server and an organization\(aqs infrastructure. knife interacts with a Chef server by using the same REST API that is used by a chef\-client\&. Role\-based authentication controls (RBAC) can be used to authorize changes when knife is run with Enterprise Chef\&. knife is configured during workstation setup, but subsequent modifications can be made using the knife.rb configuration file.
112
- .SS Common Options
113
- .sp
114
- The following options can be run with all knife sub\-commands and plug\-ins:
115
- .INDENT 0.0
116
- .TP
117
- .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
118
- The configuration file to use. For example, when knife is run from a node that is configured to be managed by the Chef server, this option is used to allow knife to use the same credentials as the chef\-client when communicating with the Chef server\&.
119
- .TP
120
- .B \fB\-\-chef\-zero\-port PORT\fP
121
- The port on which chef\-zero will listen.
122
- .TP
123
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
124
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
125
- .TP
126
- .B \fB\-\-defaults\fP
127
- Use to have knife use the default value instead of asking a user to provide one.
128
- .TP
129
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
130
- The $EDITOR that is used for all interactive commands.
131
- .TP
132
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
133
- The name of the environment. When this option is added to a command, the command will run only against the named environment. This option is ignored during search queries made using the \fBknife search\fP subcommand.
134
- .TP
135
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
136
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
137
- .TP
138
- .B \fB\-h\fP, \fB\-\-help\fP
139
- Shows help for the command.
140
- .TP
141
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
142
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
143
- .TP
144
- .B \fB\-\-[no\-]color\fP
145
- Use to view colored output.
146
- .TP
147
- .B \fB\-\-print\-after\fP
148
- Use to show data after a destructive operation.
149
- .TP
150
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
151
- The URL for the Chef server\&.
152
- .TP
153
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
154
- 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.
155
- .TP
156
- .B \fB\-v\fP, \fB\-\-version\fP
157
- The version of the chef\-client\&.
158
- .TP
159
- .B \fB\-V\fP, \fB\-\-verbose\fP
160
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
161
- .TP
162
- .B \fB\-y\fP, \fB\-\-yes\fP
163
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
164
- .TP
165
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
166
- 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\&.
167
- .UNINDENT
168
- .SS JSON Data Format
169
- .sp
170
- Most data is entered using a text editor in JSON format, unless the \fB\-\-disable\-editing\fP option is entered as part of a command. (Encrypted data bags use YAML, which is a superset of JSON\&.) JSON is a common, language\-independent data format that provides a simple text representation of arbitrary data structures. For more information about JSON, see \fI\%http://www.json.org/\fP or \fI\%http://en.wikipedia.org/wiki/JSON\fP\&.
171
- .SS Set the Text Editor
172
- .sp
173
- Some knife commands, such as \fBknife data bag edit\fP, require that information be edited as JSON data using a text editor. For example, the following command:
174
- .INDENT 0.0
175
- .INDENT 3.5
176
- .sp
177
- .nf
178
- .ft C
179
- $ knife data bag edit admins admin_name
180
- .ft P
181
- .fi
182
- .UNINDENT
183
- .UNINDENT
184
- .sp
185
- will open up the text editor with data similar to:
186
- .INDENT 0.0
187
- .INDENT 3.5
188
- .sp
189
- .nf
190
- .ft C
191
- {
192
- "id": "admin_name"
193
- }
194
- .ft P
195
- .fi
196
- .UNINDENT
197
- .UNINDENT
198
- .sp
199
- Changes to that file can then be made:
200
- .INDENT 0.0
201
- .INDENT 3.5
202
- .sp
203
- .nf
204
- .ft C
205
- {
206
- "id": "Justin C."
207
- "description": "I am passing the time by letting time pass over me ..."
208
- }
209
- .ft P
210
- .fi
211
- .UNINDENT
212
- .UNINDENT
213
- .sp
214
- The type of text editor that is used by knife can be configured by adding an entry to the knife.rb file or by setting an \fBEDITOR\fP environment variable. For example, to configure the text editor to always open with vim, add the following to the knife.rb file:
215
- .INDENT 0.0
216
- .INDENT 3.5
217
- .sp
218
- .nf
219
- .ft C
220
- knife[:editor] = "/usr/bin/vim"
221
- .ft P
222
- .fi
223
- .UNINDENT
224
- .UNINDENT
225
- .sp
226
- When a Microsoft Windows file path is enclosed in a double\-quoted string (" "), the same backslash character (\fB\e\fP) that is used to define the file path separator is also used in Ruby to define an escape character. The knife.rb file is a Ruby file; therefore, file path separators must be escaped. In addition, spaces in the file path must be replaced with \fB~1\fP so that the length of each section within the file path is not more than 8 characters. For example, if EditPad Pro is the text editor of choice and is located at the following path:
227
- .INDENT 0.0
228
- .INDENT 3.5
229
- .sp
230
- .nf
231
- .ft C
232
- C:\e\eProgram Files (x86)\eEditPad Pro\eEditPad.exe
233
- .ft P
234
- .fi
235
- .UNINDENT
236
- .UNINDENT
237
- .sp
238
- the setting in the knife.rb file would be similar to:
239
- .INDENT 0.0
240
- .INDENT 3.5
241
- .sp
242
- .nf
243
- .ft C
244
- knife[:editor] = "C:\e\eProgra~1\e\eEditPa~1\e\eEditPad.exe"
245
- .ft P
246
- .fi
247
- .UNINDENT
248
- .UNINDENT
249
- .sp
250
- One approach to working around the double\- vs. single\-quote issue is to put the single\-quotes outside of the double\-quotes. For example, for Notepad++:
251
- .INDENT 0.0
252
- .INDENT 3.5
253
- .sp
254
- .nf
255
- .ft C
256
- knife[:editor] = \(aq"C:\eProgram Files (x86)\eNotepad++\enotepad++.exe \-nosession \-multiInst"\(aq
257
- .ft P
258
- .fi
259
- .UNINDENT
260
- .UNINDENT
261
- .sp
262
- for Sublime Text:
263
- .INDENT 0.0
264
- .INDENT 3.5
265
- .sp
266
- .nf
267
- .ft C
268
- knife[:editor] = \(aq"C:\eProgram Files\eSublime Text 2\esublime_text.exe \-\-wait"\(aq
269
- .ft P
270
- .fi
271
- .UNINDENT
272
- .UNINDENT
273
- .sp
274
- for TextPad:
275
- .INDENT 0.0
276
- .INDENT 3.5
277
- .sp
278
- .nf
279
- .ft C
280
- knife[:editor] = \(aq"C:\eProgram Files (x86)\eTextPad 7\eTextPad.exe"\(aq
281
- .ft P
282
- .fi
283
- .UNINDENT
284
- .UNINDENT
285
- .sp
286
- and for vim:
287
- .INDENT 0.0
288
- .INDENT 3.5
289
- .sp
290
- .nf
291
- .ft C
292
- knife[:editor] = \(aq"C:\eProgram Files (x86)\evim\evim74\egvim.exe"\(aq
293
- .ft P
294
- .fi
295
- .UNINDENT
296
- .UNINDENT
297
- .SS Using Quotes
298
- .sp
299
- Values can be entered with double quotes (" ") or single quotes (\(aq \(aq), but this should be done consistently.
300
- .SS Sub\-commands
301
- .sp
302
- knife comes with a collection of built in subcommands that work together to provide all of the functionality required to take specific actions against any object in an organization, including cookbooks, nodes, roles, data bags, environments, and users. A knife plugin extends the functionality beyond built\-in subcommands.
303
- .sp
304
- knife has the following subcommands: \fBbootstrap\fP, \fBclient\fP, \fBconfigure\fP, \fBcookbook\fP, \fBcookbook site\fP, \fBdata bag\fP, \fBdelete\fP, \fBdeps\fP, \fBdiff\fP, \fBdownload\fP, \fBedit\fP, \fBenvironment\fP, \fBexec\fP, \fBindex rebuild\fP, \fBlist\fP, \fBnode\fP, \fBrecipe list\fP, \fBrole\fP, \fBsearch\fP, \fBshow\fP, \fBssh\fP, \fBstatus\fP, \fBtag\fP, \fBupload\fP, \fBuser\fP, and \fBxargs\fP\&.
305
- .sp
306
- \fBNOTE:\fP
307
- .INDENT 0.0
308
- .INDENT 3.5
309
- The following subcommands run only against the open source Chef server: \fBindex rebuild\fP and \fBuser\fP\&.
310
- .UNINDENT
311
- .UNINDENT
312
- .SS Syntax
313
- .sp
314
- All knife subcommands have the following syntax:
315
- .INDENT 0.0
316
- .INDENT 3.5
317
- knife subcommand [ARGUMENT] (options)
318
- .UNINDENT
319
- .UNINDENT
320
- .sp
321
- Each subcommand has its own set of arguments and options.
322
- .sp
323
- \fBNOTE:\fP
324
- .INDENT 0.0
325
- .INDENT 3.5
326
- All syntax examples in this document show variables in ALL_CAPS. For example \fB\-u PORT_LIST\fP (where PORT_LIST is a comma\-separated list of local and public UDP ports) or \fB\-F FORMAT\fP (where FORMAT determines the output format, either \fBsummary\fP, \fBtext\fP, \fBjson\fP, \fByaml\fP, or \fBpp\fP). These variables often require specific values that are unique to each organization.
327
- .UNINDENT
328
- .UNINDENT
329
- .SH AUTHOR
330
- Chef
331
- .\" Generated by docutils manpage writer.
332
- .
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE" "1" "Chef 12.0" "" "knife"
4
+ .SH NAME
5
+ knife \- The man page for the knife command line tool.
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
+ knife is a command\-line tool that provides an interface between a local chef\-repo and the Chef server\&. knife helps users to manage:
35
+ .INDENT 0.0
36
+ .IP \(bu 2
37
+ Nodes
38
+ .IP \(bu 2
39
+ Cookbooks and recipes
40
+ .IP \(bu 2
41
+ Roles
42
+ .IP \(bu 2
43
+ Stores of JSON data (data bags), including encrypted data
44
+ .IP \(bu 2
45
+ Environments
46
+ .IP \(bu 2
47
+ Cloud resources, including provisioning
48
+ .IP \(bu 2
49
+ The installation of the chef\-client on management workstations
50
+ .IP \(bu 2
51
+ Searching of indexed data on the Chef server
52
+ .UNINDENT
53
+ .sp
54
+ Knife subcommands:
55
+ .INDENT 0.0
56
+ .IP \(bu 2
57
+ knife bootstrap
58
+ .IP \(bu 2
59
+ knife client
60
+ .IP \(bu 2
61
+ knife configure
62
+ .IP \(bu 2
63
+ knife cookbook
64
+ .IP \(bu 2
65
+ knife cookbook site
66
+ .IP \(bu 2
67
+ knife data bag
68
+ .IP \(bu 2
69
+ knife delete
70
+ .IP \(bu 2
71
+ knife deps
72
+ .IP \(bu 2
73
+ knife diff
74
+ .IP \(bu 2
75
+ knife download
76
+ .IP \(bu 2
77
+ knife edit
78
+ .IP \(bu 2
79
+ knife environment
80
+ .IP \(bu 2
81
+ knife exec
82
+ .IP \(bu 2
83
+ knife list
84
+ .IP \(bu 2
85
+ knife node
86
+ .IP \(bu 2
87
+ knife raw
88
+ .IP \(bu 2
89
+ knife recipe list
90
+ .IP \(bu 2
91
+ knife role
92
+ .IP \(bu 2
93
+ knife search
94
+ .IP \(bu 2
95
+ knife show
96
+ .IP \(bu 2
97
+ knife ssh
98
+ .IP \(bu 2
99
+ knife status
100
+ .IP \(bu 2
101
+ knife tag
102
+ .IP \(bu 2
103
+ knife upload
104
+ .IP \(bu 2
105
+ knife user
106
+ .IP \(bu 2
107
+ knife xargs
108
+ .UNINDENT
109
+ .SH WORKING WITH KNIFE
110
+ .sp
111
+ knife runs from a management workstation and sits in\-between a Chef server and an organization\(aqs infrastructure. knife interacts with a Chef server by using the same REST API that is used by a chef\-client\&. Role\-based authentication controls (RBAC) can be used to authorize changes when knife is run with Enterprise Chef\&. knife is configured during workstation setup, but subsequent modifications can be made using the knife.rb configuration file.
112
+ .SS Common Options
113
+ .sp
114
+ The following options can be run with all knife sub\-commands and plug\-ins:
115
+ .INDENT 0.0
116
+ .TP
117
+ .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
118
+ The configuration file to use. For example, when knife is run from a node that is configured to be managed by the Chef server, this option is used to allow knife to use the same credentials as the chef\-client when communicating with the Chef server\&.
119
+ .TP
120
+ .B \fB\-\-chef\-zero\-port PORT\fP
121
+ The port on which chef\-zero will listen.
122
+ .TP
123
+ .B \fB\-d\fP, \fB\-\-disable\-editing\fP
124
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
125
+ .TP
126
+ .B \fB\-\-defaults\fP
127
+ Use to have knife use the default value instead of asking a user to provide one.
128
+ .TP
129
+ .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
130
+ The $EDITOR that is used for all interactive commands.
131
+ .TP
132
+ .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
133
+ The name of the environment. When this option is added to a command, the command will run only against the named environment. This option is ignored during search queries made using the \fBknife search\fP subcommand.
134
+ .TP
135
+ .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
136
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
137
+ .TP
138
+ .B \fB\-h\fP, \fB\-\-help\fP
139
+ Shows help for the command.
140
+ .TP
141
+ .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
142
+ The private key that knife will use to sign requests made by the API client to the Chef server\&.
143
+ .TP
144
+ .B \fB\-\-[no\-]color\fP
145
+ Use to view colored output.
146
+ .TP
147
+ .B \fB\-\-print\-after\fP
148
+ Use to show data after a destructive operation.
149
+ .TP
150
+ .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
151
+ The URL for the Chef server\&.
152
+ .TP
153
+ .B \fB\-u USER\fP, \fB\-\-user USER\fP
154
+ 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.
155
+ .TP
156
+ .B \fB\-v\fP, \fB\-\-version\fP
157
+ The version of the chef\-client\&.
158
+ .TP
159
+ .B \fB\-V\fP, \fB\-\-verbose\fP
160
+ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
161
+ .TP
162
+ .B \fB\-y\fP, \fB\-\-yes\fP
163
+ Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
164
+ .TP
165
+ .B \fB\-z\fP, \fB\-\-local\-mode\fP
166
+ 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\&.
167
+ .UNINDENT
168
+ .SS JSON Data Format
169
+ .sp
170
+ Most data is entered using a text editor in JSON format, unless the \fB\-\-disable\-editing\fP option is entered as part of a command. (Encrypted data bags use YAML, which is a superset of JSON\&.) JSON is a common, language\-independent data format that provides a simple text representation of arbitrary data structures. For more information about JSON, see \fI\%http://www.json.org/\fP or \fI\%http://en.wikipedia.org/wiki/JSON\fP\&.
171
+ .SS Set the Text Editor
172
+ .sp
173
+ Some knife commands, such as \fBknife data bag edit\fP, require that information be edited as JSON data using a text editor. For example, the following command:
174
+ .INDENT 0.0
175
+ .INDENT 3.5
176
+ .sp
177
+ .nf
178
+ .ft C
179
+ $ knife data bag edit admins admin_name
180
+ .ft P
181
+ .fi
182
+ .UNINDENT
183
+ .UNINDENT
184
+ .sp
185
+ will open up the text editor with data similar to:
186
+ .INDENT 0.0
187
+ .INDENT 3.5
188
+ .sp
189
+ .nf
190
+ .ft C
191
+ {
192
+ "id": "admin_name"
193
+ }
194
+ .ft P
195
+ .fi
196
+ .UNINDENT
197
+ .UNINDENT
198
+ .sp
199
+ Changes to that file can then be made:
200
+ .INDENT 0.0
201
+ .INDENT 3.5
202
+ .sp
203
+ .nf
204
+ .ft C
205
+ {
206
+ "id": "Justin C."
207
+ "description": "I am passing the time by letting time pass over me ..."
208
+ }
209
+ .ft P
210
+ .fi
211
+ .UNINDENT
212
+ .UNINDENT
213
+ .sp
214
+ The type of text editor that is used by knife can be configured by adding an entry to the knife.rb file or by setting an \fBEDITOR\fP environment variable. For example, to configure the text editor to always open with vim, add the following to the knife.rb file:
215
+ .INDENT 0.0
216
+ .INDENT 3.5
217
+ .sp
218
+ .nf
219
+ .ft C
220
+ knife[:editor] = "/usr/bin/vim"
221
+ .ft P
222
+ .fi
223
+ .UNINDENT
224
+ .UNINDENT
225
+ .sp
226
+ When a Microsoft Windows file path is enclosed in a double\-quoted string (" "), the same backslash character (\fB\e\fP) that is used to define the file path separator is also used in Ruby to define an escape character. The knife.rb file is a Ruby file; therefore, file path separators must be escaped. In addition, spaces in the file path must be replaced with \fB~1\fP so that the length of each section within the file path is not more than 8 characters. For example, if EditPad Pro is the text editor of choice and is located at the following path:
227
+ .INDENT 0.0
228
+ .INDENT 3.5
229
+ .sp
230
+ .nf
231
+ .ft C
232
+ C:\e\eProgram Files (x86)\eEditPad Pro\eEditPad.exe
233
+ .ft P
234
+ .fi
235
+ .UNINDENT
236
+ .UNINDENT
237
+ .sp
238
+ the setting in the knife.rb file would be similar to:
239
+ .INDENT 0.0
240
+ .INDENT 3.5
241
+ .sp
242
+ .nf
243
+ .ft C
244
+ knife[:editor] = "C:\e\eProgra~1\e\eEditPa~1\e\eEditPad.exe"
245
+ .ft P
246
+ .fi
247
+ .UNINDENT
248
+ .UNINDENT
249
+ .sp
250
+ One approach to working around the double\- vs. single\-quote issue is to put the single\-quotes outside of the double\-quotes. For example, for Notepad++:
251
+ .INDENT 0.0
252
+ .INDENT 3.5
253
+ .sp
254
+ .nf
255
+ .ft C
256
+ knife[:editor] = \(aq"C:\eProgram Files (x86)\eNotepad++\enotepad++.exe \-nosession \-multiInst"\(aq
257
+ .ft P
258
+ .fi
259
+ .UNINDENT
260
+ .UNINDENT
261
+ .sp
262
+ for Sublime Text:
263
+ .INDENT 0.0
264
+ .INDENT 3.5
265
+ .sp
266
+ .nf
267
+ .ft C
268
+ knife[:editor] = \(aq"C:\eProgram Files\eSublime Text 2\esublime_text.exe \-\-wait"\(aq
269
+ .ft P
270
+ .fi
271
+ .UNINDENT
272
+ .UNINDENT
273
+ .sp
274
+ for TextPad:
275
+ .INDENT 0.0
276
+ .INDENT 3.5
277
+ .sp
278
+ .nf
279
+ .ft C
280
+ knife[:editor] = \(aq"C:\eProgram Files (x86)\eTextPad 7\eTextPad.exe"\(aq
281
+ .ft P
282
+ .fi
283
+ .UNINDENT
284
+ .UNINDENT
285
+ .sp
286
+ and for vim:
287
+ .INDENT 0.0
288
+ .INDENT 3.5
289
+ .sp
290
+ .nf
291
+ .ft C
292
+ knife[:editor] = \(aq"C:\eProgram Files (x86)\evim\evim74\egvim.exe"\(aq
293
+ .ft P
294
+ .fi
295
+ .UNINDENT
296
+ .UNINDENT
297
+ .SS Using Quotes
298
+ .sp
299
+ Values can be entered with double quotes (" ") or single quotes (\(aq \(aq), but this should be done consistently.
300
+ .SS Sub\-commands
301
+ .sp
302
+ knife comes with a collection of built in subcommands that work together to provide all of the functionality required to take specific actions against any object in an organization, including cookbooks, nodes, roles, data bags, environments, and users. A knife plugin extends the functionality beyond built\-in subcommands.
303
+ .sp
304
+ knife has the following subcommands: \fBbootstrap\fP, \fBclient\fP, \fBconfigure\fP, \fBcookbook\fP, \fBcookbook site\fP, \fBdata bag\fP, \fBdelete\fP, \fBdeps\fP, \fBdiff\fP, \fBdownload\fP, \fBedit\fP, \fBenvironment\fP, \fBexec\fP, \fBindex rebuild\fP, \fBlist\fP, \fBnode\fP, \fBrecipe list\fP, \fBrole\fP, \fBsearch\fP, \fBshow\fP, \fBssh\fP, \fBstatus\fP, \fBtag\fP, \fBupload\fP, \fBuser\fP, and \fBxargs\fP\&.
305
+ .sp
306
+ \fBNOTE:\fP
307
+ .INDENT 0.0
308
+ .INDENT 3.5
309
+ The following subcommands run only against the open source Chef server: \fBindex rebuild\fP and \fBuser\fP\&.
310
+ .UNINDENT
311
+ .UNINDENT
312
+ .SS Syntax
313
+ .sp
314
+ All knife subcommands have the following syntax:
315
+ .INDENT 0.0
316
+ .INDENT 3.5
317
+ knife subcommand [ARGUMENT] (options)
318
+ .UNINDENT
319
+ .UNINDENT
320
+ .sp
321
+ Each subcommand has its own set of arguments and options.
322
+ .sp
323
+ \fBNOTE:\fP
324
+ .INDENT 0.0
325
+ .INDENT 3.5
326
+ All syntax examples in this document show variables in ALL_CAPS. For example \fB\-u PORT_LIST\fP (where PORT_LIST is a comma\-separated list of local and public UDP ports) or \fB\-F FORMAT\fP (where FORMAT determines the output format, either \fBsummary\fP, \fBtext\fP, \fBjson\fP, \fByaml\fP, or \fBpp\fP). These variables often require specific values that are unique to each organization.
327
+ .UNINDENT
328
+ .UNINDENT
329
+ .SH AUTHOR
330
+ Chef
331
+ .\" Generated by docutils manpage writer.
332
+ .