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-DOWNLOAD" "1" "Chef 11.10.0" "" "knife download"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-DOWNLOAD" "1" "Chef 11.12.0" "" "knife download"
2
4
  .SH NAME
3
5
  knife-download \- The man page for the knife download 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 download\fP subcommand is used to download roles, cookbooks, environments, nodes, and data bags from the server to the current working directory. It can be used to back up data on the server, inspect the state of one or more files, or to extract out\-of\-process changes users may have made to files on the server, such as if a user made a change that bypassed version source control. This subcommand is often used in conjunction with \fBknife diff\fP, which can be used to see exactly what changes will be downloaded, and then \fBknife upload\fP, which does the opposite of \fBknife download\fP.
34
+ The \fBknife download\fP subcommand is used to download roles, cookbooks, environments, nodes, and data bags from the Chef server to the current working directory. It can be used to back up data on the Chef server, inspect the state of one or more files, or to extract out\-of\-process changes users may have made to files on the Chef server, such as if a user made a change that bypassed version source control. This subcommand is often used in conjunction with \fBknife diff\fP, which can be used to see exactly what changes will be downloaded, and then \fBknife upload\fP, which does the opposite of \fBknife download\fP\&.
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 download [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.
@@ -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\-\-cookbook\-version VERSION\fP
67
71
  The version of a cookbook to be downloaded.
@@ -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\-\-[no\-]diff\fP
76
- Indicates that only new and modified files will be downloaded. Set to \fBfalse\fP to download all files. Default: \fB\-\-diff\fP.
80
+ Indicates that only new and modified files will be downloaded. Set to \fBfalse\fP to download all files. Default: \fB\-\-diff\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,40 +86,40 @@ 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\-\-[no\-]force\fP
88
- Use \fB\-\-force\fP to download files even when the file on the hard drive is identical to the object on the server (role, cookbook, etc.). By default, files are compared to see if they have equivalent content, and local files are only overwritten if they are different. Default: \fB\-\-no\-force\fP.
92
+ Use \fB\-\-force\fP to download files even when the file on the hard drive is identical to the object on the server (role, cookbook, etc.). By default, files are compared to see if they have equivalent content, and local files are only overwritten if they are different. Default: \fB\-\-no\-force\fP\&.
89
93
  .TP
90
94
  .B \fB\-h\fP, \fB\-\-help\fP
91
95
  Shows help for the command.
92
96
  .TP
93
97
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
94
- The private key that Knife will use to sign requests made by the API client to the server.
98
+ The private key that Knife will use to sign requests made by the API client to the Chef server\&.
95
99
  .TP
96
100
  .B \fB\-n\fP, \fB\-\-dry\-run\fP
97
- Indicates that no action is taken and that results are only printed out. Default: \fBfalse\fP.
101
+ Indicates that no action is taken and that results are only printed out. Default: \fBfalse\fP\&.
98
102
  .TP
99
103
  .B \fB\-\-print\-after\fP
100
104
  Indicates that data will be shown after a destructive operation.
101
105
  .TP
102
106
  .B \fB\-\-[no\-]purge\fP
103
- Use \fB\-\-purge\fP to delete local files and directories that do not exist on the server. By default, if a role, cookbook, etc. does not exist on the server, the local file for said role will be left alone and NOT deleted. Default: \fB\-\-no\-purge\fP.
107
+ Use \fB\-\-purge\fP to delete local files and directories that do not exist on the Chef server\&. By default, if a role, cookbook, etc. does not exist on the Chef server, the local file for said role will be left alone and NOT deleted. Default: \fB\-\-no\-purge\fP\&.
104
108
  .TP
105
109
  .B \fB\-\-[no\-]recurse\fP
106
- Use \fB\-\-no\-recurse\fP to disable downloading a directory recursively. Default: \fB\-\-recurse\fP.
110
+ Use \fB\-\-no\-recurse\fP to disable downloading a directory recursively. Default: \fB\-\-recurse\fP\&.
107
111
  .TP
108
112
  .B \fB\-\-repo\-mode MODE\fP
109
- The layout of the local chef\-repo. Possible values: \fBstatic\fP, \fBeverything\fP, or \fBhosted_everything\fP. Use \fBstatic\fP for just roles, environments, cookbooks, and data bags. By default, \fBeverything\fP and \fBhosted_everything\fP are dynamically selected depending on the server type. Default: \fBeverything\fP / \fBhosted_everything\fP.
113
+ 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
114
  .TP
111
115
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
112
- The URL for the server.
116
+ The URL for the Chef server\&.
113
117
  .TP
114
118
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
115
- 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.
119
+ 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.
116
120
  .TP
117
121
  .B \fB\-v\fP, \fB\-\-version\fP
118
- The version of the chef\-client.
122
+ The version of the chef\-client\&.
119
123
  .TP
120
124
  .B \fB\-V\fP, \fB\-\-verbose\fP
121
125
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
@@ -124,90 +128,130 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
124
128
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
125
129
  .TP
126
130
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
127
- 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.
131
+ Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
128
132
  .UNINDENT
129
133
  .sp
130
134
  \fBExamples\fP
131
135
  .sp
132
- To download the entire chef\-repo from the server, browse to the top level of the chef\-repo and enter:
136
+ To download the entire chef\-repo from the Chef server, browse to the top level of the chef\-repo and enter:
137
+ .INDENT 0.0
138
+ .INDENT 3.5
133
139
  .sp
134
140
  .nf
135
141
  .ft C
136
142
  $ knife download /
137
143
  .ft P
138
144
  .fi
145
+ .UNINDENT
146
+ .UNINDENT
139
147
  .sp
140
- To download the \fBcookbooks/\fP directory from the server, browse to the top level of the chef\-repo and enter:
148
+ To download the \fBcookbooks/\fP directory from the Chef server, browse to the top level of the chef\-repo and enter:
149
+ .INDENT 0.0
150
+ .INDENT 3.5
141
151
  .sp
142
152
  .nf
143
153
  .ft C
144
154
  $ knife download cookbooks
145
155
  .ft P
146
156
  .fi
157
+ .UNINDENT
158
+ .UNINDENT
147
159
  .sp
148
160
  or from anywhere in the chef\-repo, enter:
161
+ .INDENT 0.0
162
+ .INDENT 3.5
149
163
  .sp
150
164
  .nf
151
165
  .ft C
152
166
  $ knife download /cookbooks
153
167
  .ft P
154
168
  .fi
169
+ .UNINDENT
170
+ .UNINDENT
155
171
  .sp
156
- To download the \fBenvironments/\fP directory from the server, browse to the top level of the chef\-repo and enter:
172
+ To download the \fBenvironments/\fP directory from the Chef server, browse to the top level of the chef\-repo and enter:
173
+ .INDENT 0.0
174
+ .INDENT 3.5
157
175
  .sp
158
176
  .nf
159
177
  .ft C
160
178
  $ knife download environments
161
179
  .ft P
162
180
  .fi
181
+ .UNINDENT
182
+ .UNINDENT
163
183
  .sp
164
184
  or from anywhere in the chef\-repo, enter:
185
+ .INDENT 0.0
186
+ .INDENT 3.5
165
187
  .sp
166
188
  .nf
167
189
  .ft C
168
190
  $ knife download /environments
169
191
  .ft P
170
192
  .fi
193
+ .UNINDENT
194
+ .UNINDENT
171
195
  .sp
172
- To download an environment named "production" from the server, browse to the top level of the chef\-repo and enter:
196
+ To download an environment named "production" from the Chef server, browse to the top level of the chef\-repo and enter:
197
+ .INDENT 0.0
198
+ .INDENT 3.5
173
199
  .sp
174
200
  .nf
175
201
  .ft C
176
202
  $ knife download environments/production.json
177
203
  .ft P
178
204
  .fi
205
+ .UNINDENT
206
+ .UNINDENT
179
207
  .sp
180
208
  or from the \fBenvironments/\fP directory, enter:
209
+ .INDENT 0.0
210
+ .INDENT 3.5
181
211
  .sp
182
212
  .nf
183
213
  .ft C
184
214
  $ knife download production.json
185
215
  .ft P
186
216
  .fi
217
+ .UNINDENT
218
+ .UNINDENT
187
219
  .sp
188
- To download the \fBroles/\fP directory from the server, browse to the top level of the chef\-repo and enter:
220
+ To download the \fBroles/\fP directory from the Chef server, browse to the top level of the chef\-repo and enter:
221
+ .INDENT 0.0
222
+ .INDENT 3.5
189
223
  .sp
190
224
  .nf
191
225
  .ft C
192
226
  $ knife download roles
193
227
  .ft P
194
228
  .fi
229
+ .UNINDENT
230
+ .UNINDENT
195
231
  .sp
196
232
  or from anywhere in the chef\-repo, enter:
233
+ .INDENT 0.0
234
+ .INDENT 3.5
197
235
  .sp
198
236
  .nf
199
237
  .ft C
200
238
  $ knife download /roles
201
239
  .ft P
202
240
  .fi
241
+ .UNINDENT
242
+ .UNINDENT
203
243
  .sp
204
244
  To download all cookbooks that start with "apache" and belong to the "webserver" role, browse to the top level of the chef\-repo and enter:
245
+ .INDENT 0.0
246
+ .INDENT 3.5
205
247
  .sp
206
248
  .nf
207
249
  .ft C
208
250
  $ knife download cookbooks/apache\e* roles/webserver.json
209
251
  .ft P
210
252
  .fi
253
+ .UNINDENT
254
+ .UNINDENT
211
255
  .SH AUTHOR
212
256
  Chef
213
257
  .\" Generated by docutils manpage writer.
@@ -1,4 +1,6 @@
1
- .TH "KNIFE-EDIT" "1" "Chef 11.10.0" "" "knife edit"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-EDIT" "1" "Chef 11.12.0" "" "knife edit"
2
4
  .SH NAME
3
5
  knife-edit \- The man page for the knife edit 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 edit\fP subcommand is used to edit objects on the server. This subcommand works similar to \fBknife cookbook edit\fP, \fBknife data bag edit\fP, \fBknife environment edit\fP, \fBknife node edit\fP, and \fBknife role edit\fP, but with a single verb (and a single action).
34
+ The \fBknife edit\fP subcommand is used to edit objects on the Chef server\&. This subcommand works similar to \fBknife cookbook edit\fP, \fBknife data bag edit\fP, \fBknife environment edit\fP, \fBknife node edit\fP, and \fBknife role edit\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 edit (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,31 +80,31 @@ 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\-\-local\fP
88
- Use to show files in the local chef\-repo instead of a remote location. Default: \fBfalse\fP.
92
+ Use to show files in the local chef\-repo instead of a remote location. Default: \fBfalse\fP\&.
89
93
  .TP
90
94
  .B \fB\-\-print\-after\fP
91
95
  Indicates that data will be shown after a destructive operation.
92
96
  .TP
93
97
  .B \fB\-\-repo\-mode MODE\fP
94
- 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
+ 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\&.
95
99
  .TP
96
100
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
97
- The URL for the server.
101
+ The URL for the Chef server\&.
98
102
  .TP
99
103
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
100
- 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.
104
+ 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.
101
105
  .TP
102
106
  .B \fB\-v\fP, \fB\-\-version\fP
103
- The version of the chef\-client.
107
+ The version of the chef\-client\&.
104
108
  .TP
105
109
  .B \fB\-V\fP, \fB\-\-verbose\fP
106
110
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
@@ -109,7 +113,7 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
109
113
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
110
114
  .TP
111
115
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
112
- 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.
116
+ Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
113
117
  .UNINDENT
114
118
  .SH AUTHOR
115
119
  Chef
@@ -1,4 +1,6 @@
1
- .TH "KNIFE-ENVIRONMENT" "1" "Chef 11.10.0" "" "knife environment"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-ENVIRONMENT" "1" "Chef 11.12.0" "" "knife environment"
2
4
  .SH NAME
3
5
  knife-environment \- The man page for the knife environment subcommand.
4
6
  .
@@ -28,12 +30,10 @@ 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
- An environment is a way to map an organization\(aqs real\-life workflow to what can be configured and managed when using server. Every organization begins with a single environment called the \fB_default\fP environment, which cannot be modified (or deleted). Additional environments can be created to reflect each organization\(aqs patterns and workflow. For example, creating \fBproduction\fP, \fBstaging\fP, \fBtesting\fP, and \fBdevelopment\fP environments. Generally, an environment is also associated with one (or more) cookbook versions.
34
+ An environment is a way to map an organization\(aqs real\-life workflow to what can be configured and managed when using Chef server\&. Every organization begins with a single environment called the \fB_default\fP environment, which cannot be modified (or deleted). Additional environments can be created to reflect each organization\(aqs patterns and workflow. For example, creating \fBproduction\fP, \fBstaging\fP, \fBtesting\fP, and \fBdevelopment\fP environments. Generally, an environment is also associated with one (or more) cookbook versions.
35
35
  .sp
36
- The \fBknife environment\fP subcommand is used to manage environments within a single organization on the server.
36
+ The \fBknife environment\fP subcommand is used to manage environments within a single organization on the Chef server\&.
37
37
  .SH COMMON OPTIONS
38
38
  .sp
39
39
  The following options may be used with any of the arguments available to the \fBknife environment\fP subcommand:
@@ -58,13 +58,13 @@ The $EDITOR that is used for all interactive commands.
58
58
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
59
59
  .TP
60
60
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
61
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
61
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
62
62
  .TP
63
63
  .B \fB\-h\fP, \fB\-\-help\fP
64
64
  Shows help for the command.
65
65
  .TP
66
66
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
67
- The private key that Knife will use to sign requests made by the API client to the server.
67
+ The private key that Knife will use to sign requests made by the API client to the Chef server\&.
68
68
  .TP
69
69
  .B \fB\-\-[no\-]color\fP
70
70
  Indicates whether colored output will be used.
@@ -73,22 +73,22 @@ Indicates whether colored output will be used.
73
73
  Indicates that data will be shown after a destructive operation.
74
74
  .TP
75
75
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
76
- The URL for the server.
76
+ The URL for the Chef server\&.
77
77
  .TP
78
78
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
79
- 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.
79
+ 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.
80
80
  .TP
81
81
  .B \fB\-V\fP, \fB\-\-verbose\fP
82
82
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
83
83
  .TP
84
84
  .B \fB\-v\fP, \fB\-\-version\fP
85
- The version of the chef\-client.
85
+ The version of the chef\-client\&.
86
86
  .TP
87
87
  .B \fB\-y\fP, \fB\-\-yes\fP
88
88
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
89
89
  .TP
90
90
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
91
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo.
91
+ Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
92
92
  .UNINDENT
93
93
  .SH COMPARE
94
94
  .sp
@@ -97,12 +97,16 @@ The \fBcompare\fP argument is used to compare the cookbook version constraints t
97
97
  \fBSyntax\fP
98
98
  .sp
99
99
  This argument has the following syntax:
100
+ .INDENT 0.0
101
+ .INDENT 3.5
100
102
  .sp
101
103
  .nf
102
104
  .ft C
103
105
  $ knife environment compare [ENVIRONMENT_NAME...] (options)
104
106
  .ft P
105
107
  .fi
108
+ .UNINDENT
109
+ .UNINDENT
106
110
  .sp
107
111
  \fBOptions\fP
108
112
  .sp
@@ -119,14 +123,20 @@ Use to show only matching versions.
119
123
  \fBExample\fP
120
124
  .sp
121
125
  To compare cookbook versions for a single environment:
126
+ .INDENT 0.0
127
+ .INDENT 3.5
122
128
  .sp
123
129
  .nf
124
130
  .ft C
125
131
  $ knife environment compare development
126
132
  .ft P
127
133
  .fi
134
+ .UNINDENT
135
+ .UNINDENT
128
136
  .sp
129
137
  to return something similar to:
138
+ .INDENT 0.0
139
+ .INDENT 3.5
130
140
  .sp
131
141
  .nf
132
142
  .ft C
@@ -135,16 +145,24 @@ apache 2.3.1
135
145
  windows 4.1.2
136
146
  .ft P
137
147
  .fi
148
+ .UNINDENT
149
+ .UNINDENT
138
150
  .sp
139
151
  To compare cookbook versions for multiple environments:
152
+ .INDENT 0.0
153
+ .INDENT 3.5
140
154
  .sp
141
155
  .nf
142
156
  .ft C
143
157
  $ knife environment compare development staging
144
158
  .ft P
145
159
  .fi
160
+ .UNINDENT
161
+ .UNINDENT
146
162
  .sp
147
163
  to return something similar to:
164
+ .INDENT 0.0
165
+ .INDENT 3.5
148
166
  .sp
149
167
  .nf
150
168
  .ft C
@@ -154,16 +172,24 @@ windows 4.1.2 1.0.0
154
172
  postgresql 1.0.0 1.0.0
155
173
  .ft P
156
174
  .fi
175
+ .UNINDENT
176
+ .UNINDENT
157
177
  .sp
158
178
  To compare all cookbook versions for all environments:
179
+ .INDENT 0.0
180
+ .INDENT 3.5
159
181
  .sp
160
182
  .nf
161
183
  .ft C
162
184
  $ knife environment compare \-\-all
163
185
  .ft P
164
186
  .fi
187
+ .UNINDENT
188
+ .UNINDENT
165
189
  .sp
166
190
  to return something similar to:
191
+ .INDENT 0.0
192
+ .INDENT 3.5
167
193
  .sp
168
194
  .nf
169
195
  .ft C
@@ -197,19 +223,25 @@ chef_handler latest latest
197
223
  windows 1.0.0 4.1.2
198
224
  .ft P
199
225
  .fi
226
+ .UNINDENT
227
+ .UNINDENT
200
228
  .SH CREATE
201
229
  .sp
202
- The \fBcreate\fP argument is used to add an environment object to the server. When this argument is run, Knife will open $EDITOR to enable editing of the \fBENVIRONMENT\fP description field (unless a description is specified as part of the command). When finished, Knife will add the environment to the server.
230
+ The \fBcreate\fP argument is used to add an environment object to the Chef server\&. When this argument is run, Knife will open $EDITOR to enable editing of the \fBENVIRONMENT\fP description field (unless a description is specified as part of the command). When finished, Knife will add the environment to the Chef server\&.
203
231
  .sp
204
232
  \fBSyntax\fP
205
233
  .sp
206
234
  This argument has the following syntax:
235
+ .INDENT 0.0
236
+ .INDENT 3.5
207
237
  .sp
208
238
  .nf
209
239
  .ft C
210
240
  $ knife environment create ENVIRONMENT_NAME \-d DESCRIPTION
211
241
  .ft P
212
242
  .fi
243
+ .UNINDENT
244
+ .UNINDENT
213
245
  .sp
214
246
  \fBOptions\fP
215
247
  .sp
@@ -217,31 +249,39 @@ This argument has the following options:
217
249
  .INDENT 0.0
218
250
  .TP
219
251
  .B \fB\-d DESCRIPTION\fP, \fB\-\-description DESCRIPTION\fP
220
- The description of the environment. This value will populate the description field for the environment on the server.
252
+ The description of the environment. This value will populate the description field for the environment on the Chef server\&.
221
253
  .UNINDENT
222
254
  .sp
223
255
  \fBExamples\fP
224
256
  .sp
225
257
  To create an environment named "dev" with a description of "The development environment.":
258
+ .INDENT 0.0
259
+ .INDENT 3.5
226
260
  .sp
227
261
  .nf
228
262
  .ft C
229
263
  $ knife environment create dev \-d "The development environment."
230
264
  .ft P
231
265
  .fi
266
+ .UNINDENT
267
+ .UNINDENT
232
268
  .SH DELETE
233
269
  .sp
234
- The \fBdelete\fP argument is used to delete an environment from a server.
270
+ The \fBdelete\fP argument is used to delete an environment from a Chef server\&.
235
271
  .sp
236
272
  \fBSyntax\fP
237
273
  .sp
238
274
  This argument has the following syntax:
275
+ .INDENT 0.0
276
+ .INDENT 3.5
239
277
  .sp
240
278
  .nf
241
279
  .ft C
242
280
  $ knife environment delete ENVIRONMENT_NAME
243
281
  .ft P
244
282
  .fi
283
+ .UNINDENT
284
+ .UNINDENT
245
285
  .sp
246
286
  \fBOptions\fP
247
287
  .sp
@@ -250,27 +290,35 @@ This command does not have any specific options.
250
290
  \fBExamples\fP
251
291
  .sp
252
292
  To delete an environment named "dev", enter:
293
+ .INDENT 0.0
294
+ .INDENT 3.5
253
295
  .sp
254
296
  .nf
255
297
  .ft C
256
298
  $ knife environment delete dev
257
299
  .ft P
258
300
  .fi
301
+ .UNINDENT
302
+ .UNINDENT
259
303
  .sp
260
304
  Type \fBY\fP to confirm a deletion.
261
305
  .SH EDIT
262
306
  .sp
263
- The \fBedit\fP argument is used to edit the attributes of an environment. When this argument is run, Knife will open $EDITOR to enable editing of \fBENVIRONMENT\fP attributes. When finished, Knife will update the server with those changes.
307
+ The \fBedit\fP argument is used to edit the attributes of an environment. When this argument is run, Knife will open $EDITOR to enable editing of \fBENVIRONMENT\fP attributes. When finished, Knife will update the Chef server with those changes.
264
308
  .sp
265
309
  \fBSyntax\fP
266
310
  .sp
267
311
  This argument has the following syntax:
312
+ .INDENT 0.0
313
+ .INDENT 3.5
268
314
  .sp
269
315
  .nf
270
316
  .ft C
271
317
  $ knife environment edit ENVIRONMENT_NAME
272
318
  .ft P
273
319
  .fi
320
+ .UNINDENT
321
+ .UNINDENT
274
322
  .sp
275
323
  \fBOptions\fP
276
324
  .sp
@@ -279,12 +327,16 @@ This command does not have any specific options.
279
327
  \fBExamples\fP
280
328
  .sp
281
329
  To edit an environment named "devops", enter:
330
+ .INDENT 0.0
331
+ .INDENT 3.5
282
332
  .sp
283
333
  .nf
284
334
  .ft C
285
335
  $ knife environment edit devops
286
336
  .ft P
287
337
  .fi
338
+ .UNINDENT
339
+ .UNINDENT
288
340
  .SH FROM FILE
289
341
  .sp
290
342
  The \fBfrom file\fP argument is used to add or update an environment using a JSON or Ruby DSL description. It must be run with the \fBcreate\fP or \fBedit\fP arguments.
@@ -292,12 +344,16 @@ The \fBfrom file\fP argument is used to add or update an environment using a JSO
292
344
  \fBSyntax\fP
293
345
  .sp
294
346
  This argument has the following syntax:
347
+ .INDENT 0.0
348
+ .INDENT 3.5
295
349
  .sp
296
350
  .nf
297
351
  .ft C
298
352
  $ knife environment [create | edit] from file FILE (options)
299
353
  .ft P
300
354
  .fi
355
+ .UNINDENT
356
+ .UNINDENT
301
357
  .sp
302
358
  \fBOptions\fP
303
359
  .sp
@@ -311,33 +367,45 @@ Indicates that all environments found at the specified path will be uploaded.
311
367
  \fBExamples\fP
312
368
  .sp
313
369
  To add an environment using data contained in a JSON file:
370
+ .INDENT 0.0
371
+ .INDENT 3.5
314
372
  .sp
315
373
  .nf
316
374
  .ft C
317
375
  $ knife environment create devops from file "path to JSON file"
318
376
  .ft P
319
377
  .fi
378
+ .UNINDENT
379
+ .UNINDENT
320
380
  .sp
321
381
  or:
382
+ .INDENT 0.0
383
+ .INDENT 3.5
322
384
  .sp
323
385
  .nf
324
386
  .ft C
325
387
  $ knife environment edit devops from file "path to JSON file"
326
388
  .ft P
327
389
  .fi
390
+ .UNINDENT
391
+ .UNINDENT
328
392
  .SH LIST
329
393
  .sp
330
- The \fBlist\fP argument is used to list all of the environments that are currently available on the server.
394
+ The \fBlist\fP argument is used to list all of the environments that are currently available on the Chef server\&.
331
395
  .sp
332
396
  \fBSyntax\fP
333
397
  .sp
334
398
  This argument has the following syntax:
399
+ .INDENT 0.0
400
+ .INDENT 3.5
335
401
  .sp
336
402
  .nf
337
403
  .ft C
338
404
  $ knife environment list \-w
339
405
  .ft P
340
406
  .fi
407
+ .UNINDENT
408
+ .UNINDENT
341
409
  .sp
342
410
  \fBOptions\fP
343
411
  .sp
@@ -351,12 +419,16 @@ Indicates that the corresponding URIs will be shown.
351
419
  \fBExamples\fP
352
420
  .sp
353
421
  To view a list of environments:
422
+ .INDENT 0.0
423
+ .INDENT 3.5
354
424
  .sp
355
425
  .nf
356
426
  .ft C
357
427
  $ knife environment list \-w
358
428
  .ft P
359
429
  .fi
430
+ .UNINDENT
431
+ .UNINDENT
360
432
  .SH SHOW
361
433
  .sp
362
434
  The \fBshow\fP argument is used to display information about the specified environment.
@@ -364,12 +436,16 @@ The \fBshow\fP argument is used to display information about the specified envir
364
436
  \fBSyntax\fP
365
437
  .sp
366
438
  This argument has the following syntax:
439
+ .INDENT 0.0
440
+ .INDENT 3.5
367
441
  .sp
368
442
  .nf
369
443
  .ft C
370
444
  $ knife environment show ENVIRONMENT_NAME
371
445
  .ft P
372
446
  .fi
447
+ .UNINDENT
448
+ .UNINDENT
373
449
  .sp
374
450
  \fBOptions\fP
375
451
  .sp
@@ -378,14 +454,20 @@ This command does not have any specific options.
378
454
  \fBExamples\fP
379
455
  .sp
380
456
  To view information about the "dev" environment enter:
457
+ .INDENT 0.0
458
+ .INDENT 3.5
381
459
  .sp
382
460
  .nf
383
461
  .ft C
384
462
  $ knife environment show dev
385
463
  .ft P
386
464
  .fi
465
+ .UNINDENT
466
+ .UNINDENT
387
467
  .sp
388
468
  to return:
469
+ .INDENT 0.0
470
+ .INDENT 3.5
389
471
  .sp
390
472
  .nf
391
473
  .ft C
@@ -404,16 +486,22 @@ override_attributes:
404
486
  \e\e
405
487
  .ft P
406
488
  .fi
489
+ .UNINDENT
490
+ .UNINDENT
407
491
  .sp
408
492
  To view information in JSON format, use the \fB\-F\fP common option as part of the command like this:
493
+ .INDENT 0.0
494
+ .INDENT 3.5
409
495
  .sp
410
496
  .nf
411
497
  .ft C
412
498
  $ knife role show devops \-F json
413
499
  .ft P
414
500
  .fi
501
+ .UNINDENT
502
+ .UNINDENT
415
503
  .sp
416
- Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP.
504
+ Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
417
505
  .SH AUTHOR
418
506
  Chef
419
507
  .\" Generated by docutils manpage writer.