chef 11.12.8-x86-mingw32 → 11.14.0.alpha.2-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (193) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +4 -2
  3. data/distro/common/html/_sources/index.txt +6 -0
  4. data/distro/common/html/_sources/knife_ssl_check.txt +41 -0
  5. data/distro/common/html/_sources/knife_ssl_fetch.txt +41 -0
  6. data/distro/common/html/_static/basic.css +2 -5
  7. data/distro/common/html/_static/doctools.js +5 -14
  8. data/distro/common/html/_static/jquery.js +2 -154
  9. data/distro/common/html/_static/pygments.css +2 -2
  10. data/distro/common/html/_static/searchtools.js +212 -150
  11. data/distro/common/html/_static/underscore.js +29 -21
  12. data/distro/common/html/_static/websupport.js +1 -1
  13. data/distro/common/html/ctl_chef_client.html +15 -18
  14. data/distro/common/html/ctl_chef_server.html +7 -7
  15. data/distro/common/html/ctl_chef_shell.html +6 -6
  16. data/distro/common/html/ctl_chef_solo.html +7 -8
  17. data/distro/common/html/index.html +34 -24
  18. data/distro/common/html/knife.html +23 -24
  19. data/distro/common/html/knife_bootstrap.html +13 -9
  20. data/distro/common/html/knife_client.html +10 -11
  21. data/distro/common/html/knife_common_options.html +6 -7
  22. data/distro/common/html/knife_configure.html +3 -4
  23. data/distro/common/html/knife_cookbook.html +18 -11
  24. data/distro/common/html/knife_cookbook_site.html +14 -14
  25. data/distro/common/html/knife_data_bag.html +24 -23
  26. data/distro/common/html/knife_delete.html +4 -5
  27. data/distro/common/html/knife_deps.html +4 -5
  28. data/distro/common/html/knife_diff.html +6 -7
  29. data/distro/common/html/knife_download.html +12 -13
  30. data/distro/common/html/knife_edit.html +4 -5
  31. data/distro/common/html/knife_environment.html +8 -9
  32. data/distro/common/html/knife_exec.html +9 -10
  33. data/distro/common/html/knife_index_rebuild.html +4 -5
  34. data/distro/common/html/knife_list.html +8 -9
  35. data/distro/common/html/knife_node.html +34 -33
  36. data/distro/common/html/knife_raw.html +2 -3
  37. data/distro/common/html/knife_recipe_list.html +3 -4
  38. data/distro/common/html/knife_role.html +30 -29
  39. data/distro/common/html/knife_search.html +7 -7
  40. data/distro/common/html/knife_show.html +4 -5
  41. data/distro/common/html/knife_ssh.html +2 -3
  42. data/distro/common/html/knife_ssl_check.html +148 -0
  43. data/distro/common/html/knife_ssl_fetch.html +152 -0
  44. data/distro/common/html/knife_status.html +4 -5
  45. data/distro/common/html/knife_tag.html +2 -3
  46. data/distro/common/html/knife_upload.html +5 -6
  47. data/distro/common/html/knife_user.html +9 -10
  48. data/distro/common/html/knife_using.html +12 -12
  49. data/distro/common/html/knife_xargs.html +11 -12
  50. data/distro/common/html/search.html +1 -2
  51. data/distro/common/html/searchindex.js +1 -1
  52. data/distro/common/man/man1/chef-shell.1 +19 -11
  53. data/distro/common/man/man1/knife-bootstrap.1 +35 -19
  54. data/distro/common/man/man1/knife-client.1 +111 -28
  55. data/distro/common/man/man1/knife-configure.1 +30 -14
  56. data/distro/common/man/man1/knife-cookbook-site.1 +105 -22
  57. data/distro/common/man/man1/knife-cookbook.1 +164 -23
  58. data/distro/common/man/man1/knife-data-bag.1 +157 -33
  59. data/distro/common/man/man1/knife-delete.1 +21 -17
  60. data/distro/common/man/man1/knife-deps.1 +60 -16
  61. data/distro/common/man/man1/knife-diff.1 +37 -17
  62. data/distro/common/man/man1/knife-download.1 +68 -24
  63. data/distro/common/man/man1/knife-edit.1 +19 -15
  64. data/distro/common/man/man1/knife-environment.1 +105 -17
  65. data/distro/common/man/man1/knife-exec.1 +78 -18
  66. data/distro/common/man/man1/knife-index-rebuild.1 +16 -8
  67. data/distro/common/man/man1/knife-list.1 +39 -23
  68. data/distro/common/man/man1/knife-node.1 +170 -22
  69. data/distro/common/man/man1/knife-raw.1 +33 -13
  70. data/distro/common/man/man1/knife-recipe-list.1 +17 -5
  71. data/distro/common/man/man1/knife-role.1 +86 -18
  72. data/distro/common/man/man1/knife-search.1 +80 -16
  73. data/distro/common/man/man1/knife-show.1 +30 -14
  74. data/distro/common/man/man1/knife-ssh.1 +54 -14
  75. data/distro/common/man/man1/knife-ssl-check.1 +207 -0
  76. data/distro/common/man/man1/knife-ssl-fetch.1 +207 -0
  77. data/distro/common/man/man1/knife-status.1 +48 -12
  78. data/distro/common/man/man1/knife-tag.1 +30 -10
  79. data/distro/common/man/man1/knife-upload.1 +72 -20
  80. data/distro/common/man/man1/knife-user.1 +79 -23
  81. data/distro/common/man/man1/knife-xargs.1 +61 -53
  82. data/distro/common/man/man8/chef-client.8 +87 -29
  83. data/distro/common/man/man8/chef-solo.8 +36 -15
  84. data/lib/chef/application.rb +19 -14
  85. data/lib/chef/application/client.rb +5 -0
  86. data/lib/chef/application/solo.rb +5 -0
  87. data/lib/chef/application/windows_service_manager.rb +3 -0
  88. data/lib/chef/chef_fs/chef_fs_data_store.rb +72 -24
  89. data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbook_dir.rb +20 -4
  90. data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbooks_dir.rb +20 -1
  91. data/lib/chef/chef_fs/file_system/file_system_entry.rb +10 -2
  92. data/lib/chef/client.rb +2 -3
  93. data/lib/chef/config.rb +34 -8
  94. data/lib/chef/cookbook/cookbook_version_loader.rb +45 -4
  95. data/lib/chef/cookbook_version.rb +38 -30
  96. data/lib/chef/dsl/recipe.rb +4 -1
  97. data/lib/chef/event_dispatch/base.rb +14 -0
  98. data/lib/chef/event_dispatch/events_output_stream.rb +29 -0
  99. data/lib/chef/exceptions.rb +8 -0
  100. data/lib/chef/formatters/base.rb +16 -45
  101. data/lib/chef/formatters/doc.rb +51 -26
  102. data/lib/chef/formatters/indentable_output_stream.rb +165 -0
  103. data/lib/chef/knife/node_environment_set.rb +54 -0
  104. data/lib/chef/knife/user_create.rb +1 -1
  105. data/lib/chef/monkey_patches/pathname.rb +32 -0
  106. data/lib/chef/node.rb +1 -1
  107. data/lib/chef/platform/provider_mapping.rb +345 -338
  108. data/lib/chef/policy_builder/expand_node_object.rb +1 -1
  109. data/lib/chef/policy_builder/policyfile.rb +1 -1
  110. data/lib/chef/provider.rb +1 -0
  111. data/lib/chef/provider/git.rb +1 -1
  112. data/lib/chef/provider/link.rb +2 -2
  113. data/lib/chef/provider/remote_file/content.rb +1 -1
  114. data/lib/chef/provider/remote_file/local_file.rb +8 -2
  115. data/lib/chef/provider/service/arch.rb +0 -1
  116. data/lib/chef/provider/service/debian.rb +0 -2
  117. data/lib/chef/provider/service/freebsd.rb +2 -1
  118. data/lib/chef/provider/service/gentoo.rb +1 -1
  119. data/lib/chef/provider/service/init.rb +0 -1
  120. data/lib/chef/provider/service/insserv.rb +0 -2
  121. data/lib/chef/provider/service/invokercd.rb +0 -2
  122. data/lib/chef/provider/service/macosx.rb +2 -1
  123. data/lib/chef/provider/service/redhat.rb +0 -1
  124. data/lib/chef/provider/service/simple.rb +1 -0
  125. data/lib/chef/provider/service/solaris.rb +1 -0
  126. data/lib/chef/provider/service/systemd.rb +1 -1
  127. data/lib/chef/provider/service/upstart.rb +1 -1
  128. data/lib/chef/provider/user.rb +9 -9
  129. data/lib/chef/provider/user/solaris.rb +2 -0
  130. data/lib/chef/resource.rb +1 -0
  131. data/lib/chef/resource/remote_file.rb +32 -6
  132. data/lib/chef/run_context.rb +22 -0
  133. data/lib/chef/run_lock.rb +43 -4
  134. data/lib/chef/version.rb +2 -2
  135. data/spec/functional/http/simple_spec.rb +84 -0
  136. data/spec/functional/resource/remote_file_spec.rb +107 -43
  137. data/spec/functional/rest_spec.rb +94 -0
  138. data/spec/functional/run_lock_spec.rb +1 -1
  139. data/spec/functional/win32/service_manager_spec.rb +6 -0
  140. data/spec/integration/knife/chef_fs_data_store_spec.rb +2 -0
  141. data/spec/integration/recipes/lwrp_inline_resources_spec.rb +76 -0
  142. data/spec/spec_helper.rb +2 -0
  143. data/spec/support/mock/platform.rb +7 -0
  144. data/spec/support/pedant/pedant_config.rb +121 -0
  145. data/spec/support/pedant/run_pedant.rb +63 -0
  146. data/spec/support/pedant/stickywicket.pem +27 -0
  147. data/spec/support/shared/functional/http.rb +242 -0
  148. data/spec/support/shared/unit/api_error_inspector.rb +2 -2
  149. data/spec/unit/api_client_spec.rb +2 -2
  150. data/spec/unit/application/client_spec.rb +6 -1
  151. data/spec/unit/application/knife_spec.rb +4 -0
  152. data/spec/unit/application/solo_spec.rb +2 -0
  153. data/spec/unit/application_spec.rb +7 -0
  154. data/spec/unit/client_spec.rb +16 -0
  155. data/spec/unit/config_spec.rb +3 -20
  156. data/spec/unit/cookbook_version_spec.rb +224 -122
  157. data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +2 -2
  158. data/spec/unit/formatters/error_inspectors/cookbook_resolve_error_inspector_spec.rb +2 -2
  159. data/spec/unit/formatters/error_inspectors/cookbook_sync_error_inspector_spec.rb +2 -2
  160. data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +2 -2
  161. data/spec/unit/formatters/error_inspectors/run_list_expansion_error_inspector_spec.rb +2 -2
  162. data/spec/unit/handler_spec.rb +0 -1
  163. data/spec/unit/knife/client_bulk_delete_spec.rb +3 -0
  164. data/spec/unit/knife/cookbook_bulk_delete_spec.rb +2 -0
  165. data/spec/unit/knife/cookbook_metadata_spec.rb +2 -2
  166. data/spec/unit/knife/cookbook_site_install_spec.rb +3 -1
  167. data/spec/unit/knife/cookbook_upload_spec.rb +10 -10
  168. data/spec/unit/knife/node_environment_set_spec.rb +80 -0
  169. data/spec/unit/knife/user_create_spec.rb +6 -4
  170. data/spec/unit/knife/user_edit_spec.rb +5 -0
  171. data/spec/unit/knife_spec.rb +3 -0
  172. data/spec/unit/mixin/securable_spec.rb +18 -20
  173. data/spec/unit/node/attribute_spec.rb +15 -2
  174. data/spec/unit/node/immutable_collections_spec.rb +4 -4
  175. data/spec/unit/provider/cron_spec.rb +14 -14
  176. data/spec/unit/provider/git_spec.rb +4 -4
  177. data/spec/unit/provider/group_spec.rb +1 -1
  178. data/spec/unit/provider/ohai_spec.rb +2 -2
  179. data/spec/unit/provider/remote_file/content_spec.rb +58 -35
  180. data/spec/unit/provider/remote_file/local_file_spec.rb +23 -0
  181. data/spec/unit/provider/service/solaris_smf_service_spec.rb +13 -13
  182. data/spec/unit/resource/mount_spec.rb +0 -1
  183. data/spec/unit/resource/remote_file_spec.rb +29 -0
  184. data/spec/unit/resource_spec.rb +1 -1
  185. data/spec/unit/run_context_spec.rb +7 -0
  186. data/spec/unit/run_lock_spec.rb +98 -0
  187. data/spec/unit/version_constraint_spec.rb +1 -1
  188. metadata +166 -153
  189. data/distro/common/html/_static/chef.css +0 -507
  190. data/distro/common/html/_static/chef_logo.png +0 -0
  191. data/lib/chef/checksum/storage.rb +0 -18
  192. data/lib/chef/checksum/storage/filesystem.rb +0 -56
  193. data/spec/unit/checksum/storage/filesystem_spec.rb +0 -70
@@ -1,4 +1,6 @@
1
- .TH "KNIFE-DELETE" "1" "Chef 11.10.0" "" "knife delete"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-DELETE" "1" "Chef 11.12.0" "" "knife delete"
2
4
  .SH NAME
3
5
  knife-delete \- The man page for the knife delete subcommand.
4
6
  .
@@ -28,20 +30,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
28
30
  .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
31
  .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
32
  ..
31
- .\" Man page generated from reStructuredText.
32
- .
33
33
  .sp
34
- The \fBknife delete\fP subcommand is used to delete an object from a server. This subcommand works similar to \fBknife cookbook delete\fP, \fBknife data bag delete\fP, \fBknife environment delete\fP, \fBknife node delete\fP, and \fBknife role delete\fP, but with a single verb (and a single action).
34
+ The \fBknife delete\fP subcommand is used to delete an object from a Chef server\&. This subcommand works similar to \fBknife cookbook delete\fP, \fBknife data bag delete\fP, \fBknife environment delete\fP, \fBknife node delete\fP, and \fBknife role delete\fP, but with a single verb (and a single action).
35
35
  .sp
36
36
  \fBSyntax\fP
37
37
  .sp
38
- This argument has the following syntax:
38
+ This subcommand has the following syntax:
39
+ .INDENT 0.0
40
+ .INDENT 3.5
39
41
  .sp
40
42
  .nf
41
43
  .ft C
42
44
  $ knife delete [PATTERN...] (options)
43
45
  .ft P
44
46
  .fi
47
+ .UNINDENT
48
+ .UNINDENT
45
49
  .sp
46
50
  \fBOptions\fP
47
51
  .sp
@@ -49,13 +53,13 @@ This subcommand has the following options:
49
53
  .INDENT 0.0
50
54
  .TP
51
55
  .B \fB\-\-both\fP
52
- Indicates that both local and remote copies of an object should be deleted. Default: \fBfalse\fP.
56
+ Indicates that both local and remote copies of an object should be deleted. Default: \fBfalse\fP\&.
53
57
  .TP
54
58
  .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
55
59
  The configuration file to use.
56
60
  .TP
57
61
  .B \fB\-\-chef\-repo\-path PATH\fP
58
- 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.
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.
59
63
  .TP
60
64
  .B \fB\-\-chef\-zero\-port PORT\fP
61
65
  The port on which chef\-zero will listen.
@@ -64,7 +68,7 @@ The port on which chef\-zero will listen.
64
68
  Indicates whether colored output will be used.
65
69
  .TP
66
70
  .B \fB\-\-concurrency\fP
67
- The number of allowed concurrent connections. Default: \fB10\fP.
71
+ The number of allowed concurrent connections. Default: \fB10\fP\&.
68
72
  .TP
69
73
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
70
74
  Indicates that $EDITOR will not be opened; data will be accepted as\-is.
@@ -79,34 +83,34 @@ The $EDITOR that is used for all interactive commands.
79
83
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
80
84
  .TP
81
85
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
82
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
86
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
83
87
  .TP
84
88
  .B \fB\-h\fP, \fB\-\-help\fP
85
89
  Shows help for the command.
86
90
  .TP
87
91
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
88
- The private key that Knife will use to sign requests made by the API client to the server.
92
+ The private key that Knife will use to sign requests made by the API client to the Chef server\&.
89
93
  .TP
90
94
  .B \fB\-\-local\fP
91
- Indicates that only the local copy of an object should be deleted. (The remote copy will not be deleted.) Default: \fBfalse\fP.
95
+ Indicates that only the local copy of an object should be deleted. (The remote copy will not be deleted.) Default: \fBfalse\fP\&.
92
96
  .TP
93
97
  .B \fB\-\-print\-after\fP
94
98
  Indicates that data will be shown after a destructive operation.
95
99
  .TP
96
100
  .B \fB\-r\fP, \fB\-\-[no\-]recurse\fP
97
- Use \fB\-\-recurse\fP to delete directories recursively. Default: \fB\-\-no\-recurse\fP.
101
+ Use \fB\-\-recurse\fP to delete directories recursively. Default: \fB\-\-no\-recurse\fP\&.
98
102
  .TP
99
103
  .B \fB\-\-repo\-mode MODE\fP
100
- 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.
104
+ 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\&.
101
105
  .TP
102
106
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
103
- The URL for the server.
107
+ The URL for the Chef server\&.
104
108
  .TP
105
109
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
106
- The user name used by Knife to sign requests made by the API client to the server. Authentication will fail if the user name does not match the private key.
110
+ 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.
107
111
  .TP
108
112
  .B \fB\-v\fP, \fB\-\-version\fP
109
- The version of the chef\-client.
113
+ The version of the chef\-client\&.
110
114
  .TP
111
115
  .B \fB\-V\fP, \fB\-\-verbose\fP
112
116
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
@@ -115,7 +119,7 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
115
119
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
116
120
  .TP
117
121
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
118
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo.
122
+ Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
119
123
  .UNINDENT
120
124
  .SH AUTHOR
121
125
  Chef
@@ -1,4 +1,6 @@
1
- .TH "KNIFE-DEPS" "1" "Chef 11.10.0" "" "knife deps"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-DEPS" "1" "Chef 11.12.0" "" "knife deps"
2
4
  .SH NAME
3
5
  knife-deps \- The man page for the knife deps subcommand.
4
6
  .
@@ -28,20 +30,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
28
30
  .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
31
  .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
32
  ..
31
- .\" Man page generated from reStructuredText.
32
- .
33
33
  .sp
34
34
  The \fBknife deps\fP subcommand is used to identify dependencies for a node, role, or cookbook.
35
35
  .sp
36
36
  \fBSyntax\fP
37
37
  .sp
38
- This argument has the following syntax:
38
+ This subcommand has the following syntax:
39
+ .INDENT 0.0
40
+ .INDENT 3.5
39
41
  .sp
40
42
  .nf
41
43
  .ft C
42
44
  $ knife deps (options)
43
45
  .ft P
44
46
  .fi
47
+ .UNINDENT
48
+ .UNINDENT
45
49
  .sp
46
50
  \fBOptions\fP
47
51
  .sp
@@ -52,7 +56,7 @@ This subcommand has the following options:
52
56
  The configuration file to use.
53
57
  .TP
54
58
  .B \fB\-\-chef\-repo\-path PATH\fP
55
- 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.
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.
56
60
  .TP
57
61
  .B \fB\-\-chef\-zero\-port PORT\fP
58
62
  The port on which chef\-zero will listen.
@@ -61,7 +65,7 @@ The port on which chef\-zero will listen.
61
65
  Indicates whether colored output will be used.
62
66
  .TP
63
67
  .B \fB\-\-concurrency\fP
64
- The number of allowed concurrent connections. Default: \fB10\fP.
68
+ The number of allowed concurrent connections. Default: \fB10\fP\&.
65
69
  .TP
66
70
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
67
71
  Indicates that $EDITOR will not be opened; data will be accepted as\-is.
@@ -76,37 +80,37 @@ The $EDITOR that is used for all interactive commands.
76
80
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
77
81
  .TP
78
82
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
79
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
83
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
80
84
  .TP
81
85
  .B \fB\-h\fP, \fB\-\-help\fP
82
86
  Shows help for the command.
83
87
  .TP
84
88
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
85
- The private key that Knife will use to sign requests made by the API client to the server.
89
+ The private key that Knife will use to sign requests made by the API client to the Chef server\&.
86
90
  .TP
87
91
  .B \fB\-\-print\-after\fP
88
92
  Indicates that data will be shown after a destructive operation.
89
93
  .TP
90
94
  .B \fB\-\-[no\-]recurse\fP
91
- Use \fB\-\-recurse\fP to list dependencies recursively. This option can only be used when \fB\-\-tree\fP is set to \fBtrue\fP. Default: \fB\-\-no\-recurse\fP.
95
+ Use \fB\-\-recurse\fP to list dependencies recursively. This option can only be used when \fB\-\-tree\fP is set to \fBtrue\fP\&. Default: \fB\-\-no\-recurse\fP\&.
92
96
  .TP
93
97
  .B \fB\-\-remote\fP
94
- Indicates that dependencies will be determined from objects located on the server instead of the local chef\-repo. Default: \fBfalse\fP.
98
+ Indicates that dependencies will be determined from objects located on the Chef server instead of the local chef\-repo\&. Default: \fBfalse\fP\&.
95
99
  .TP
96
100
  .B \fB\-\-repo\-mode MODE\fP
97
- 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.
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\&.
98
102
  .TP
99
103
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
100
- The URL for the server.
104
+ The URL for the Chef server\&.
101
105
  .TP
102
106
  .B \fB\-\-tree\fP
103
- Indicates that dependencies are shown in a visual tree structure (including duplicates, if they exist). Default: \fBfalse\fP.
107
+ Indicates that dependencies are shown in a visual tree structure (including duplicates, if they exist). Default: \fBfalse\fP\&.
104
108
  .TP
105
109
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
106
- The user name used by Knife to sign requests made by the API client to the server. Authentication will fail if the user name does not match the private key.
110
+ 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.
107
111
  .TP
108
112
  .B \fB\-v\fP, \fB\-\-version\fP
109
- The version of the chef\-client.
113
+ The version of the chef\-client\&.
110
114
  .TP
111
115
  .B \fB\-V\fP, \fB\-\-verbose\fP
112
116
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
@@ -115,60 +119,90 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
115
119
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
116
120
  .TP
117
121
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
118
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo.
122
+ Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
119
123
  .UNINDENT
120
124
  .sp
121
125
  \fBExamples\fP
126
+ .INDENT 0.0
127
+ .INDENT 3.5
122
128
  .sp
123
129
  .nf
124
130
  .ft C
125
131
  $ knife deps nodes/node_name.json
126
132
  .ft P
127
133
  .fi
134
+ .UNINDENT
135
+ .UNINDENT
136
+ .INDENT 0.0
137
+ .INDENT 3.5
128
138
  .sp
129
139
  .nf
130
140
  .ft C
131
141
  $ knife deps roles/role_name.json
132
142
  .ft P
133
143
  .fi
144
+ .UNINDENT
145
+ .UNINDENT
146
+ .INDENT 0.0
147
+ .INDENT 3.5
134
148
  .sp
135
149
  .nf
136
150
  .ft C
137
151
  $ knife deps cookbooks/cookbook_name.json
138
152
  .ft P
139
153
  .fi
154
+ .UNINDENT
155
+ .UNINDENT
156
+ .INDENT 0.0
157
+ .INDENT 3.5
140
158
  .sp
141
159
  .nf
142
160
  .ft C
143
161
  $ knife deps environments/environment_name.json
144
162
  .ft P
145
163
  .fi
164
+ .UNINDENT
165
+ .UNINDENT
146
166
  .sp
147
167
  To find the dependencies for a combination of nodes, cookbooks, roles, and/or environments:
168
+ .INDENT 0.0
169
+ .INDENT 3.5
148
170
  .sp
149
171
  .nf
150
172
  .ft C
151
173
  $ knife deps cookbooks/git.json cookbooks/github.json roles/base.json environments/desert.json nodes/mynode.json
152
174
  .ft P
153
175
  .fi
176
+ .UNINDENT
177
+ .UNINDENT
154
178
  .sp
155
179
  A wildcard can be used to return all of the child nodes. For example, all of the environments:
180
+ .INDENT 0.0
181
+ .INDENT 3.5
156
182
  .sp
157
183
  .nf
158
184
  .ft C
159
185
  $ knife deps environments/*.json
160
186
  .ft P
161
187
  .fi
188
+ .UNINDENT
189
+ .UNINDENT
162
190
  .sp
163
191
  Use the \fB\-\-tree\fP option to view the results with structure:
192
+ .INDENT 0.0
193
+ .INDENT 3.5
164
194
  .sp
165
195
  .nf
166
196
  .ft C
167
197
  $ knife deps roles/webserver.json
168
198
  .ft P
169
199
  .fi
200
+ .UNINDENT
201
+ .UNINDENT
170
202
  .sp
171
203
  to return something like:
204
+ .INDENT 0.0
205
+ .INDENT 3.5
172
206
  .sp
173
207
  .nf
174
208
  .ft C
@@ -180,22 +214,32 @@ roles/webserver.json
180
214
  cookbooks/apache2
181
215
  .ft P
182
216
  .fi
217
+ .UNINDENT
218
+ .UNINDENT
183
219
  .sp
184
220
  The output of \fBknife deps\fP can be passed to \fBknife upload\fP:
221
+ .INDENT 0.0
222
+ .INDENT 3.5
185
223
  .sp
186
224
  .nf
187
225
  .ft C
188
226
  $ knife upload \(gaknife deps nodes/*.json
189
227
  .ft P
190
228
  .fi
229
+ .UNINDENT
230
+ .UNINDENT
191
231
  .sp
192
232
  The output of \fBknife deps\fP can be passed to \fBknife xargs\fP:
233
+ .INDENT 0.0
234
+ .INDENT 3.5
193
235
  .sp
194
236
  .nf
195
237
  .ft C
196
238
  $ knife deps nodes/*.json | xargs knife upload
197
239
  .ft P
198
240
  .fi
241
+ .UNINDENT
242
+ .UNINDENT
199
243
  .SH AUTHOR
200
244
  Chef
201
245
  .\" Generated by docutils manpage writer.
@@ -1,4 +1,6 @@
1
- .TH "KNIFE-DIFF" "1" "Chef 11.10.0" "" "knife diff"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-DIFF" "1" "Chef 11.12.0" "" "knife diff"
2
4
  .SH NAME
3
5
  knife-diff \- The man page for the knife diff subcommand.
4
6
  .
@@ -28,20 +30,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
28
30
  .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
31
  .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
32
  ..
31
- .\" Man page generated from reStructuredText.
32
- .
33
33
  .sp
34
- The \fBknife diff\fP subcommand is used to compare the differences between files and directories on the server and in the chef\-repo. For example, to compare files on the server prior to an uploading or downloading files using the \fBknife download\fP and \fBknife upload\fP subcommands, or to ensure that certain files in multiple production environments are the same. This subcommand is similar to the \fBgit diff\fP command that can be used to diff what is in the chef\-repo with what is synced to a git repository.
34
+ The \fBknife diff\fP subcommand is used to compare the differences between files and directories on the Chef server and in the chef\-repo\&. For example, to compare files on the Chef server prior to an uploading or downloading files using the \fBknife download\fP and \fBknife upload\fP subcommands, or to ensure that certain files in multiple production environments are the same. This subcommand is similar to the \fBgit diff\fP command that can be used to diff what is in the chef\-repo with what is synced to a git repository.
35
35
  .sp
36
36
  \fBSyntax\fP
37
37
  .sp
38
- This argument has the following syntax:
38
+ This subcommand has the following syntax:
39
+ .INDENT 0.0
40
+ .INDENT 3.5
39
41
  .sp
40
42
  .nf
41
43
  .ft C
42
44
  $ knife diff [PATTERN...] (options)
43
45
  .ft P
44
46
  .fi
47
+ .UNINDENT
48
+ .UNINDENT
45
49
  .sp
46
50
  \fBOptions\fP
47
51
  .sp
@@ -52,7 +56,7 @@ This subcommand has the following options:
52
56
  The configuration file to use.
53
57
  .TP
54
58
  .B \fB\-\-chef\-repo\-path PATH\fP
55
- 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.
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.
56
60
  .TP
57
61
  .B \fB\-\-chef\-zero\-port PORT\fP
58
62
  The port on which chef\-zero will listen.
@@ -64,7 +68,7 @@ Indicates whether colored output will be used.
64
68
  The version of a cookbook to be downloaded.
65
69
  .TP
66
70
  .B \fB\-\-concurrency\fP
67
- The number of allowed concurrent connections. Default: \fB10\fP.
71
+ The number of allowed concurrent connections. Default: \fB10\fP\&.
68
72
  .TP
69
73
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
70
74
  Indicates that $EDITOR will not be opened; data will be accepted as\-is.
@@ -73,7 +77,7 @@ Indicates that $EDITOR will not be opened; data will be accepted as\-is.
73
77
  Indicates that Knife will use the default value, instead of asking a user to provide one.
74
78
  .TP
75
79
  .B \fB\-\-diff\-filter=[(A|D|M|T)...[*]]\fP
76
- Indicates that files will be selected that have been added (\fBA\fP), deleted (\fBD\fP), modified (\fBM\fP), and/or have had their type changed (\fBT\fP). Any combination of filter characters may be used, including no filter characters. Use \fB*\fP to select all paths if a file matches other criteria in the comparison. Default value: \fBnil\fP.
80
+ Indicates that files will be selected that have been added (\fBA\fP), deleted (\fBD\fP), modified (\fBM\fP), and/or have had their type changed (\fBT\fP). Any combination of filter characters may be used, including no filter characters. Use \fB*\fP to select all paths if a file matches other criteria in the comparison. Default value: \fBnil\fP\&.
77
81
  .TP
78
82
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
79
83
  The $EDITOR that is used for all interactive commands.
@@ -82,13 +86,13 @@ The $EDITOR that is used for all interactive commands.
82
86
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
83
87
  .TP
84
88
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
85
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
89
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
86
90
  .TP
87
91
  .B \fB\-h\fP, \fB\-\-help\fP
88
92
  Shows help for the command.
89
93
  .TP
90
94
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
91
- The private key that Knife will use to sign requests made by the API client to the server.
95
+ The private key that Knife will use to sign requests made by the API client to the Chef server\&.
92
96
  .TP
93
97
  .B \fB\-\-name\-only\fP
94
98
  Indicates that only the names of modified files will be shown.
@@ -97,22 +101,22 @@ Indicates that only the names of modified files will be shown.
97
101
  Indicates that only the names of files with a status of \fBAdded\fP, \fBDeleted\fP, \fBModified\fP, or \fBType Changed\fP will be shown.
98
102
  .TP
99
103
  .B \fB\-\-no\-recurse\fP
100
- Use \fB\-\-no\-recurse\fP to disable listing a directory recursively. Default: \fB\-\-recurse\fP.
104
+ Use \fB\-\-no\-recurse\fP to disable listing a directory recursively. Default: \fB\-\-recurse\fP\&.
101
105
  .TP
102
106
  .B \fB\-\-print\-after\fP
103
107
  Indicates that data will be shown after a destructive operation.
104
108
  .TP
105
109
  .B \fB\-\-repo\-mode MODE\fP
106
- 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.
110
+ 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\&.
107
111
  .TP
108
112
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
109
- The URL for the server.
113
+ The URL for the Chef server\&.
110
114
  .TP
111
115
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
112
- The user name used by Knife to sign requests made by the API client to the server. Authentication will fail if the user name does not match the private key.
116
+ 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.
113
117
  .TP
114
118
  .B \fB\-v\fP, \fB\-\-version\fP
115
- The version of the chef\-client.
119
+ The version of the chef\-client\&.
116
120
  .TP
117
121
  .B \fB\-V\fP, \fB\-\-verbose\fP
118
122
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
@@ -121,7 +125,7 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
121
125
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
122
126
  .TP
123
127
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
124
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo.
128
+ Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
125
129
  .UNINDENT
126
130
  .sp
127
131
  \fBknife.rb File Settings\fP
@@ -163,30 +167,44 @@ Use to add the \fB\-\-repo\-mode\fP option.
163
167
  \fBExamples\fP
164
168
  .sp
165
169
  To compare the "base.json" role to a "webserver.json" role, enter:
170
+ .INDENT 0.0
171
+ .INDENT 3.5
166
172
  .sp
167
173
  .nf
168
174
  .ft C
169
175
  $ knife diff roles/base.json roles/webserver.json
170
176
  .ft P
171
177
  .fi
178
+ .UNINDENT
179
+ .UNINDENT
172
180
  .sp
173
- To compare the differences between the local chef\-repo and the files that are on the server, enter:
181
+ To compare the differences between the local chef\-repo and the files that are on the Chef server, enter:
182
+ .INDENT 0.0
183
+ .INDENT 3.5
174
184
  .sp
175
185
  .nf
176
186
  .ft C
177
187
  $ knife diff
178
188
  .ft P
179
189
  .fi
190
+ .UNINDENT
191
+ .UNINDENT
180
192
  .sp
181
193
  To diff a node named \fBnode\-lb\fP and then only return files that have been added, deleted, modified, or changed, enter:
194
+ .INDENT 0.0
195
+ .INDENT 3.5
182
196
  .sp
183
197
  .nf
184
198
  .ft C
185
199
  $ knife diff \-\-name\-status node\-lb
186
200
  .ft P
187
201
  .fi
202
+ .UNINDENT
203
+ .UNINDENT
188
204
  .sp
189
205
  to return something like:
206
+ .INDENT 0.0
207
+ .INDENT 3.5
190
208
  .sp
191
209
  .nf
192
210
  .ft C
@@ -200,6 +218,8 @@ node\-lb/.gitignore
200
218
  node\-lb/Rakefile
201
219
  .ft P
202
220
  .fi
221
+ .UNINDENT
222
+ .UNINDENT
203
223
  .SH AUTHOR
204
224
  Chef
205
225
  .\" Generated by docutils manpage writer.