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

Sign up to get free protection for your applications and to get access to all the features.
Files changed (145) hide show
  1. data/CONTRIBUTING.md +0 -4
  2. data/README.md +1 -1
  3. data/distro/common/man/man1/chef-shell.1 +4 -4
  4. data/distro/common/man/man1/knife-bootstrap.1 +14 -11
  5. data/distro/common/man/man1/knife-client.1 +14 -11
  6. data/distro/common/man/man1/knife-configure.1 +7 -7
  7. data/distro/common/man/man1/knife-cookbook-site.1 +23 -23
  8. data/distro/common/man/man1/knife-cookbook.1 +23 -23
  9. data/distro/common/man/man1/knife-data-bag.1 +13 -13
  10. data/distro/common/man/man1/knife-delete.1 +9 -9
  11. data/distro/common/man/man1/knife-deps.1 +9 -9
  12. data/distro/common/man/man1/knife-diff.1 +10 -10
  13. data/distro/common/man/man1/knife-download.1 +9 -9
  14. data/distro/common/man/man1/knife-edit.1 +7 -7
  15. data/distro/common/man/man1/knife-environment.1 +10 -10
  16. data/distro/common/man/man1/knife-exec.1 +7 -7
  17. data/distro/common/man/man1/knife-index-rebuild.1 +1 -1
  18. data/distro/common/man/man1/knife-list.1 +12 -12
  19. data/distro/common/man/man1/knife-node.1 +12 -9
  20. data/distro/common/man/man1/knife-raw.1 +7 -7
  21. data/distro/common/man/man1/knife-recipe-list.1 +1 -1
  22. data/distro/common/man/man1/knife-role.1 +8 -8
  23. data/distro/common/man/man1/knife-search.1 +9 -9
  24. data/distro/common/man/man1/knife-serve.1 +109 -0
  25. data/distro/common/man/man1/knife-show.1 +8 -8
  26. data/distro/common/man/man1/knife-ssh.1 +9 -9
  27. data/distro/common/man/man1/knife-ssl-check.1 +9 -9
  28. data/distro/common/man/man1/knife-ssl-fetch.1 +10 -10
  29. data/distro/common/man/man1/knife-status.1 +9 -9
  30. data/distro/common/man/man1/knife-tag.1 +7 -7
  31. data/distro/common/man/man1/knife-upload.1 +10 -10
  32. data/distro/common/man/man1/knife-user.1 +9 -9
  33. data/distro/common/man/man1/knife-xargs.1 +7 -7
  34. data/distro/common/man/man1/knife.1 +118 -14
  35. data/distro/common/man/man8/chef-client.8 +13 -10
  36. data/distro/common/man/man8/chef-solo.8 +13 -14
  37. data/distro/common/markdown/man1/knife.mkd +1 -1
  38. data/lib/chef/application/knife.rb +1 -1
  39. data/lib/chef/application/windows_service.rb +0 -1
  40. data/lib/chef/chef_fs/file_system.rb +6 -2
  41. data/lib/chef/config.rb +3 -2
  42. data/lib/chef/config_fetcher.rb +1 -1
  43. data/lib/chef/cookbook/metadata.rb +20 -14
  44. data/lib/chef/cookbook/synchronizer.rb +24 -13
  45. data/lib/chef/encrypted_data_bag_item/decryptor.rb +3 -3
  46. data/lib/chef/encrypted_data_bag_item/encryptor.rb +2 -2
  47. data/lib/chef/exceptions.rb +1 -0
  48. data/lib/chef/file_content_management/deploy/mv_windows.rb +1 -1
  49. data/lib/chef/formatters/error_inspectors/resource_failure_inspector.rb +1 -1
  50. data/lib/chef/http.rb +6 -1
  51. data/lib/chef/http/http_request.rb +9 -1
  52. data/lib/chef/http/simple.rb +2 -1
  53. data/lib/chef/json_compat.rb +5 -16
  54. data/lib/chef/knife/bootstrap.rb +2 -0
  55. data/lib/chef/knife/bootstrap/archlinux-gems.erb +2 -2
  56. data/lib/chef/knife/core/object_loader.rb +3 -1
  57. data/lib/chef/knife/ssh.rb +14 -7
  58. data/lib/chef/mixin/convert_to_class_name.rb +1 -0
  59. data/lib/chef/mixin/windows_architecture_helper.rb +24 -4
  60. data/lib/chef/platform/provider_mapping.rb +13 -0
  61. data/lib/chef/provider/env/windows.rb +3 -6
  62. data/lib/chef/provider/git.rb +1 -2
  63. data/lib/chef/provider/log.rb +15 -1
  64. data/lib/chef/provider/package/apt.rb +3 -3
  65. data/lib/chef/provider/package/dpkg.rb +35 -16
  66. data/lib/chef/provider/package/paludis.rb +91 -0
  67. data/lib/chef/provider/package/rpm.rb +3 -2
  68. data/lib/chef/provider/package/yum-dump.py +6 -6
  69. data/lib/chef/provider/package/yum.rb +2 -0
  70. data/lib/chef/provider/registry_key.rb +4 -5
  71. data/lib/chef/provider/remote_file/cache_control_data.rb +1 -1
  72. data/lib/chef/provider/service/solaris.rb +1 -1
  73. data/lib/chef/provider/service/upstart.rb +2 -1
  74. data/lib/chef/provider/service/windows.rb +37 -9
  75. data/lib/chef/provider/user/pw.rb +1 -1
  76. data/lib/chef/provider/user/useradd.rb +1 -1
  77. data/lib/chef/provider/windows_script.rb +2 -1
  78. data/lib/chef/providers.rb +1 -0
  79. data/lib/chef/resource.rb +10 -0
  80. data/lib/chef/resource/file.rb +0 -9
  81. data/lib/chef/resource/package.rb +14 -4
  82. data/lib/chef/resource/paludis_package.rb +33 -0
  83. data/lib/chef/resource/registry_key.rb +62 -3
  84. data/lib/chef/resource/service.rb +21 -4
  85. data/lib/chef/resource_reporter.rb +10 -0
  86. data/lib/chef/resources.rb +1 -0
  87. data/lib/chef/role.rb +14 -10
  88. data/lib/chef/shell.rb +8 -0
  89. data/lib/chef/shell/shell_session.rb +3 -3
  90. data/lib/chef/user.rb +12 -11
  91. data/lib/chef/util/selinux.rb +1 -1
  92. data/lib/chef/version.rb +1 -1
  93. data/lib/chef/version_constraint.rb +6 -5
  94. data/lib/chef/win32/api/process.rb +1 -0
  95. data/lib/chef/win32/api/system.rb +14 -0
  96. data/lib/chef/win32/error.rb +1 -1
  97. data/lib/chef/win32/security.rb +5 -5
  98. data/lib/chef/win32/version.rb +6 -2
  99. data/spec/data/trusted_certs/opscode.pem +57 -35
  100. data/spec/functional/application_spec.rb +2 -2
  101. data/spec/functional/resource/mount_spec.rb +3 -1
  102. data/spec/functional/shell_spec.rb +10 -0
  103. data/spec/functional/tiny_server_spec.rb +2 -2
  104. data/spec/support/chef_helpers.rb +1 -1
  105. data/spec/support/shared/functional/securable_resource.rb +11 -2
  106. data/spec/support/shared/functional/securable_resource_with_reporting.rb +13 -2
  107. data/spec/tiny_server.rb +1 -1
  108. data/spec/unit/config_spec.rb +5 -0
  109. data/spec/unit/cookbook/metadata_spec.rb +24 -0
  110. data/spec/unit/environment_spec.rb +6 -0
  111. data/spec/unit/http/http_request_spec.rb +91 -0
  112. data/spec/unit/http_spec.rb +23 -0
  113. data/spec/unit/knife/bootstrap_spec.rb +2 -2
  114. data/spec/unit/knife/ssh_spec.rb +7 -13
  115. data/spec/unit/knife_spec.rb +1 -1
  116. data/spec/unit/mixin/convert_to_class_name_spec.rb +4 -0
  117. data/spec/unit/provider/git_spec.rb +2 -2
  118. data/spec/unit/provider/log_spec.rb +18 -0
  119. data/spec/unit/provider/mount/solaris_spec.rb +3 -1
  120. data/spec/unit/provider/package/apt_spec.rb +85 -40
  121. data/spec/unit/provider/package/dpkg_spec.rb +24 -48
  122. data/spec/unit/provider/package/paludis_spec.rb +135 -0
  123. data/spec/unit/provider/package/rpm_spec.rb +40 -32
  124. data/spec/unit/provider/package/yum_spec.rb +11 -4
  125. data/spec/unit/provider/registry_key_spec.rb +67 -53
  126. data/spec/unit/provider/remote_file/cache_control_data_spec.rb +10 -1
  127. data/spec/unit/provider/service/solaris_smf_service_spec.rb +23 -2
  128. data/spec/unit/provider/service/upstart_service_spec.rb +7 -0
  129. data/spec/unit/provider/service/windows_spec.rb +72 -0
  130. data/spec/unit/provider/user/pw_spec.rb +21 -4
  131. data/spec/unit/provider/user/useradd_spec.rb +10 -0
  132. data/spec/unit/resource/package_spec.rb +26 -18
  133. data/spec/unit/resource/registry_key_spec.rb +28 -0
  134. data/spec/unit/resource/service_spec.rb +14 -0
  135. data/spec/unit/resource_reporter_spec.rb +37 -12
  136. data/spec/unit/resource_spec.rb +41 -6
  137. data/spec/unit/rest_spec.rb +2 -2
  138. data/spec/unit/role_spec.rb +46 -28
  139. data/spec/unit/shell/shell_session_spec.rb +42 -2
  140. data/spec/unit/shell_spec.rb +1 -1
  141. data/spec/unit/user_spec.rb +12 -0
  142. data/spec/unit/util/selinux_spec.rb +4 -4
  143. data/spec/unit/version_constraint_spec.rb +14 -2
  144. metadata +195 -161
  145. checksums.yaml +0 -7
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-DATA-BAG" "1" "Chef 11.12.0" "" "knife data bag"
3
+ .TH "KNIFE-DATA-BAG" "1" "Chef 11.14" "" "knife data bag"
4
4
  .SH NAME
5
5
  knife-data-bag \- The man page for the knife data bag subcommand.
6
6
  .
@@ -48,10 +48,10 @@ The port on which chef\-zero will listen.
48
48
  The configuration file to use.
49
49
  .TP
50
50
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
51
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
51
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
52
52
  .TP
53
53
  .B \fB\-\-defaults\fP
54
- Indicates that Knife will use the default value, instead of asking a user to provide one.
54
+ Use to have Knife use the default value instead of asking a user to provide one.
55
55
  .TP
56
56
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
57
57
  The $EDITOR that is used for all interactive commands.
@@ -69,10 +69,10 @@ Shows help for the command.
69
69
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
70
70
  .TP
71
71
  .B \fB\-\-[no\-]color\fP
72
- Indicates whether colored output will be used.
72
+ Use to view colored output.
73
73
  .TP
74
74
  .B \fB\-\-print\-after\fP
75
- Indicates that data will be shown after a destructive operation.
75
+ Use to show data after a destructive operation.
76
76
  .TP
77
77
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
78
78
  The URL for the Chef server\&.
@@ -87,10 +87,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
87
87
  The version of the chef\-client\&.
88
88
  .TP
89
89
  .B \fB\-y\fP, \fB\-\-yes\fP
90
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
90
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
91
91
  .TP
92
92
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
93
- 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\&.
93
+ 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\&.
94
94
  .UNINDENT
95
95
  .SH CREATE
96
96
  .sp
@@ -308,15 +308,15 @@ to:
308
308
  .UNINDENT
309
309
  .SH FROM FILE
310
310
  .sp
311
- The \fBfrom file\fP argument is used to create a data bag on the Chef server from a file. The path to the data bag file must specify one of the following:
311
+ The \fBfrom file\fP argument is used to:
312
312
  .INDENT 0.0
313
313
  .IP \(bu 2
314
- the name of a data bag
314
+ Add a data bag item to a data bag
315
315
  .IP \(bu 2
316
- a relative or absolute path to a file
316
+ Update the contents of an existing data bag item
317
317
  .UNINDENT
318
318
  .sp
319
- If the name of a data bag is specified, Knife will search for the data bag in \fB\&./data_bags/bag_name/file\fP\&. Once opened, the JSON file should be a hash that contains at least an ID key which represents the name of the data bag item.
319
+ The data bag itself must already exist on the Chef server and must be specified as part of the command. The contents of the data bag item are specified using a JSON file. This JSON file may be located at a relative or absolute path; its location must be specified as part of the command. The JSON file that defines the contents of the data bag item must at least contain the name of the data bag item\-\-\-\fB"id": "name"\fP\&.
320
320
  .sp
321
321
  \fBWARNING:\fP
322
322
  .INDENT 0.0
@@ -345,7 +345,7 @@ This argument has the following options:
345
345
  .INDENT 0.0
346
346
  .TP
347
347
  .B \fB\-a\fP, \fB\-\-all\fP
348
- Indicates that all data bags found at the specified path will be uploaded.
348
+ Use to upload all data bags found at the specified path.
349
349
  .TP
350
350
  .B \fB\-\-secret SECRET\fP
351
351
  The encryption key that is used for values contained within a data bag item.
@@ -410,7 +410,7 @@ This argument has the following options:
410
410
  .INDENT 0.0
411
411
  .TP
412
412
  .B \fB\-w\fP, \fB\-\-with\-uri\fP
413
- Indicates that the corresponding URIs will be shown.
413
+ Use to show the corresponding URIs.
414
414
  .UNINDENT
415
415
  .sp
416
416
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-DELETE" "1" "Chef 11.12.0" "" "knife delete"
3
+ .TH "KNIFE-DELETE" "1" "Chef 11.14" "" "knife delete"
4
4
  .SH NAME
5
5
  knife-delete \- The man page for the knife delete subcommand.
6
6
  .
@@ -53,7 +53,7 @@ This subcommand has the following options:
53
53
  .INDENT 0.0
54
54
  .TP
55
55
  .B \fB\-\-both\fP
56
- Indicates that both local and remote copies of an object should be deleted. Default: \fBfalse\fP\&.
56
+ Use to delete both local and remote copies of an object. Default: \fBfalse\fP\&.
57
57
  .TP
58
58
  .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
59
59
  The configuration file to use.
@@ -65,16 +65,16 @@ The path to the chef\-repo\&. This setting will override the default path to the
65
65
  The port on which chef\-zero will listen.
66
66
  .TP
67
67
  .B \fB\-\-[no\-]color\fP
68
- Indicates whether colored output will be used.
68
+ Use to view colored output.
69
69
  .TP
70
70
  .B \fB\-\-concurrency\fP
71
71
  The number of allowed concurrent connections. Default: \fB10\fP\&.
72
72
  .TP
73
73
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
74
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
74
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
75
75
  .TP
76
76
  .B \fB\-\-defaults\fP
77
- Indicates that Knife will use the default value, instead of asking a user to provide one.
77
+ Use to have Knife use the default value instead of asking a user to provide one.
78
78
  .TP
79
79
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
80
80
  The $EDITOR that is used for all interactive commands.
@@ -92,10 +92,10 @@ Shows help for the command.
92
92
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
93
93
  .TP
94
94
  .B \fB\-\-local\fP
95
- Indicates that only the local copy of an object should be deleted. (The remote copy will not be deleted.) Default: \fBfalse\fP\&.
95
+ Use to delete only the local copy of an object. (A remote copy will not be deleted.) Default: \fBfalse\fP\&.
96
96
  .TP
97
97
  .B \fB\-\-print\-after\fP
98
- Indicates that data will be shown after a destructive operation.
98
+ Use to show data after a destructive operation.
99
99
  .TP
100
100
  .B \fB\-r\fP, \fB\-\-[no\-]recurse\fP
101
101
  Use \fB\-\-recurse\fP to delete directories recursively. Default: \fB\-\-no\-recurse\fP\&.
@@ -116,10 +116,10 @@ The version of the chef\-client\&.
116
116
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
117
117
  .TP
118
118
  .B \fB\-y\fP, \fB\-\-yes\fP
119
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
119
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
120
120
  .TP
121
121
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
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\&.
122
+ 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\&.
123
123
  .UNINDENT
124
124
  .SH AUTHOR
125
125
  Chef
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-DEPS" "1" "Chef 11.12.0" "" "knife deps"
3
+ .TH "KNIFE-DEPS" "1" "Chef 11.14" "" "knife deps"
4
4
  .SH NAME
5
5
  knife-deps \- The man page for the knife deps subcommand.
6
6
  .
@@ -62,16 +62,16 @@ The path to the chef\-repo\&. This setting will override the default path to the
62
62
  The port on which chef\-zero will listen.
63
63
  .TP
64
64
  .B \fB\-\-[no\-]color\fP
65
- Indicates whether colored output will be used.
65
+ Use to view colored output.
66
66
  .TP
67
67
  .B \fB\-\-concurrency\fP
68
68
  The number of allowed concurrent connections. Default: \fB10\fP\&.
69
69
  .TP
70
70
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
71
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
71
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
72
72
  .TP
73
73
  .B \fB\-\-defaults\fP
74
- Indicates that Knife will use the default value, instead of asking a user to provide one.
74
+ Use to have Knife use the default value instead of asking a user to provide one.
75
75
  .TP
76
76
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
77
77
  The $EDITOR that is used for all interactive commands.
@@ -89,13 +89,13 @@ Shows help for the command.
89
89
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
90
90
  .TP
91
91
  .B \fB\-\-print\-after\fP
92
- Indicates that data will be shown after a destructive operation.
92
+ Use to show data after a destructive operation.
93
93
  .TP
94
94
  .B \fB\-\-[no\-]recurse\fP
95
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\&.
96
96
  .TP
97
97
  .B \fB\-\-remote\fP
98
- Indicates that dependencies will be determined from objects located on the Chef server instead of the local chef\-repo\&. Default: \fBfalse\fP\&.
98
+ Use to determine dependencies from objects located on the Chef server instead of in the local chef\-repo\&. Default: \fBfalse\fP\&.
99
99
  .TP
100
100
  .B \fB\-\-repo\-mode MODE\fP
101
101
  The layout of the local chef\-repo\&. Possible values: \fBstatic\fP, \fBeverything\fP, or \fBhosted_everything\fP\&. Use \fBstatic\fP for just roles, environments, cookbooks, and data bags. By default, \fBeverything\fP and \fBhosted_everything\fP are dynamically selected depending on the server type. Default: \fBeverything\fP / \fBhosted_everything\fP\&.
@@ -104,7 +104,7 @@ The layout of the local chef\-repo\&. Possible values: \fBstatic\fP, \fBeverythi
104
104
  The URL for the Chef server\&.
105
105
  .TP
106
106
  .B \fB\-\-tree\fP
107
- Indicates that dependencies are shown in a visual tree structure (including duplicates, if they exist). Default: \fBfalse\fP\&.
107
+ Use to show dependencies in a visual tree structure (including duplicates, if they exist). Default: \fBfalse\fP\&.
108
108
  .TP
109
109
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
110
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.
@@ -116,10 +116,10 @@ The version of the chef\-client\&.
116
116
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
117
117
  .TP
118
118
  .B \fB\-y\fP, \fB\-\-yes\fP
119
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
119
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
120
120
  .TP
121
121
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
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\&.
122
+ 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\&.
123
123
  .UNINDENT
124
124
  .sp
125
125
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-DIFF" "1" "Chef 11.12.0" "" "knife diff"
3
+ .TH "KNIFE-DIFF" "1" "Chef 11.14" "" "knife diff"
4
4
  .SH NAME
5
5
  knife-diff \- The man page for the knife diff subcommand.
6
6
  .
@@ -62,7 +62,7 @@ The path to the chef\-repo\&. This setting will override the default path to the
62
62
  The port on which chef\-zero will listen.
63
63
  .TP
64
64
  .B \fB\-\-[no\-]color\fP
65
- Indicates whether colored output will be used.
65
+ Use to view colored output.
66
66
  .TP
67
67
  .B \fB\-\-cookbook\-version VERSION\fP
68
68
  The version of a cookbook to be downloaded.
@@ -71,13 +71,13 @@ The version of a cookbook to be downloaded.
71
71
  The number of allowed concurrent connections. Default: \fB10\fP\&.
72
72
  .TP
73
73
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
74
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
74
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
75
75
  .TP
76
76
  .B \fB\-\-defaults\fP
77
- Indicates that Knife will use the default value, instead of asking a user to provide one.
77
+ Use to have Knife use the default value instead of asking a user to provide one.
78
78
  .TP
79
79
  .B \fB\-\-diff\-filter=[(A|D|M|T)...[*]]\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\&.
80
+ Use to select only files 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\&.
81
81
  .TP
82
82
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
83
83
  The $EDITOR that is used for all interactive commands.
@@ -95,16 +95,16 @@ Shows help for the command.
95
95
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
96
96
  .TP
97
97
  .B \fB\-\-name\-only\fP
98
- Indicates that only the names of modified files will be shown.
98
+ Use to show only the names of modified files.
99
99
  .TP
100
100
  .B \fB\-\-name\-status\fP
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.
101
+ Use to show only the names of files with a status of \fBAdded\fP, \fBDeleted\fP, \fBModified\fP, or \fBType Changed\fP\&.
102
102
  .TP
103
103
  .B \fB\-\-no\-recurse\fP
104
104
  Use \fB\-\-no\-recurse\fP to disable listing a directory recursively. Default: \fB\-\-recurse\fP\&.
105
105
  .TP
106
106
  .B \fB\-\-print\-after\fP
107
- Indicates that data will be shown after a destructive operation.
107
+ Use to show data after a destructive operation.
108
108
  .TP
109
109
  .B \fB\-\-repo\-mode MODE\fP
110
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\&.
@@ -122,10 +122,10 @@ The version of the chef\-client\&.
122
122
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
123
123
  .TP
124
124
  .B \fB\-y\fP, \fB\-\-yes\fP
125
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
125
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
126
126
  .TP
127
127
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
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\&.
128
+ 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\&.
129
129
  .UNINDENT
130
130
  .sp
131
131
  \fBknife.rb File Settings\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-DOWNLOAD" "1" "Chef 11.12.0" "" "knife download"
3
+ .TH "KNIFE-DOWNLOAD" "1" "Chef 11.14" "" "knife download"
4
4
  .SH NAME
5
5
  knife-download \- The man page for the knife download subcommand.
6
6
  .
@@ -62,7 +62,7 @@ The path to the chef\-repo\&. This setting will override the default path to the
62
62
  The port on which chef\-zero will listen.
63
63
  .TP
64
64
  .B \fB\-\-[no\-]color\fP
65
- Indicates whether colored output will be used.
65
+ Use to view colored output.
66
66
  .TP
67
67
  .B \fB\-\-concurrency\fP
68
68
  The number of allowed concurrent connections. Default: \fB10\fP\&.
@@ -71,13 +71,13 @@ The number of allowed concurrent connections. Default: \fB10\fP\&.
71
71
  The version of a cookbook to be downloaded.
72
72
  .TP
73
73
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
74
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
74
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
75
75
  .TP
76
76
  .B \fB\-\-defaults\fP
77
- Indicates that Knife will use the default value, instead of asking a user to provide one.
77
+ Use to have Knife use the default value instead of asking a user to provide one.
78
78
  .TP
79
79
  .B \fB\-\-[no\-]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\&.
80
+ Use to download only new and modified files. Set to \fBfalse\fP to download all files. Default: \fB\-\-diff\fP\&.
81
81
  .TP
82
82
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
83
83
  The $EDITOR that is used for all interactive commands.
@@ -98,10 +98,10 @@ Shows help for the command.
98
98
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
99
99
  .TP
100
100
  .B \fB\-n\fP, \fB\-\-dry\-run\fP
101
- Indicates that no action is taken and that results are only printed out. Default: \fBfalse\fP\&.
101
+ Use to take no action and only print out results. Default: \fBfalse\fP\&.
102
102
  .TP
103
103
  .B \fB\-\-print\-after\fP
104
- Indicates that data will be shown after a destructive operation.
104
+ Use to show data after a destructive operation.
105
105
  .TP
106
106
  .B \fB\-\-[no\-]purge\fP
107
107
  Use \fB\-\-purge\fP to delete 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\&.
@@ -125,10 +125,10 @@ The version of the chef\-client\&.
125
125
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
126
126
  .TP
127
127
  .B \fB\-y\fP, \fB\-\-yes\fP
128
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
128
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
129
129
  .TP
130
130
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
131
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
131
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
132
132
  .UNINDENT
133
133
  .sp
134
134
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-EDIT" "1" "Chef 11.12.0" "" "knife edit"
3
+ .TH "KNIFE-EDIT" "1" "Chef 11.14" "" "knife edit"
4
4
  .SH NAME
5
5
  knife-edit \- The man page for the knife edit subcommand.
6
6
  .
@@ -62,16 +62,16 @@ The path to the chef\-repo\&. This setting will override the default path to the
62
62
  The port on which chef\-zero will listen.
63
63
  .TP
64
64
  .B \fB\-\-[no\-]color\fP
65
- Indicates whether colored output will be used.
65
+ Use to view colored output.
66
66
  .TP
67
67
  .B \fB\-\-concurrency\fP
68
68
  The number of allowed concurrent connections. Default: \fB10\fP\&.
69
69
  .TP
70
70
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
71
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
71
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
72
72
  .TP
73
73
  .B \fB\-\-defaults\fP
74
- Indicates that Knife will use the default value, instead of asking a user to provide one.
74
+ Use to have Knife use the default value instead of asking a user to provide one.
75
75
  .TP
76
76
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
77
77
  The $EDITOR that is used for all interactive commands.
@@ -92,7 +92,7 @@ The private key that Knife will use to sign requests made by the API client to t
92
92
  Use to show files in the local chef\-repo instead of a remote location. Default: \fBfalse\fP\&.
93
93
  .TP
94
94
  .B \fB\-\-print\-after\fP
95
- Indicates that data will be shown after a destructive operation.
95
+ Use to show data after a destructive operation.
96
96
  .TP
97
97
  .B \fB\-\-repo\-mode MODE\fP
98
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\&.
@@ -110,10 +110,10 @@ The version of the chef\-client\&.
110
110
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
111
111
  .TP
112
112
  .B \fB\-y\fP, \fB\-\-yes\fP
113
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
113
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
114
114
  .TP
115
115
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
116
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
116
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
117
117
  .UNINDENT
118
118
  .SH AUTHOR
119
119
  Chef
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-ENVIRONMENT" "1" "Chef 11.12.0" "" "knife environment"
3
+ .TH "KNIFE-ENVIRONMENT" "1" "Chef 11.14" "" "knife environment"
4
4
  .SH NAME
5
5
  knife-environment \- The man page for the knife environment subcommand.
6
6
  .
@@ -46,10 +46,10 @@ The port on which chef\-zero will listen.
46
46
  The configuration file to use.
47
47
  .TP
48
48
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
49
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
49
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
50
50
  .TP
51
51
  .B \fB\-\-defaults\fP
52
- Indicates that Knife will use the default value, instead of asking a user to provide one.
52
+ Use to have Knife use the default value instead of asking a user to provide one.
53
53
  .TP
54
54
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
55
55
  The $EDITOR that is used for all interactive commands.
@@ -67,10 +67,10 @@ Shows help for the command.
67
67
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
68
68
  .TP
69
69
  .B \fB\-\-[no\-]color\fP
70
- Indicates whether colored output will be used.
70
+ Use to view colored output.
71
71
  .TP
72
72
  .B \fB\-\-print\-after\fP
73
- Indicates that data will be shown after a destructive operation.
73
+ Use to show data after a destructive operation.
74
74
  .TP
75
75
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
76
76
  The URL for the Chef server\&.
@@ -85,10 +85,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
85
85
  The version of the chef\-client\&.
86
86
  .TP
87
87
  .B \fB\-y\fP, \fB\-\-yes\fP
88
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
88
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
89
89
  .TP
90
90
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
91
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
91
+ Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
92
92
  .UNINDENT
93
93
  .SH COMPARE
94
94
  .sp
@@ -114,7 +114,7 @@ This argument has the following options:
114
114
  .INDENT 0.0
115
115
  .TP
116
116
  .B \fB\-a\fP, \fB\-\-all\fP
117
- Indicates that all environments found at the specified path will be uploaded.
117
+ Use to upload all environments found at the specified path.
118
118
  .TP
119
119
  .B \fB\-m\fP, \fB\-\-mismatch\fP
120
120
  Use to show only matching versions.
@@ -361,7 +361,7 @@ This argument has the following options:
361
361
  .INDENT 0.0
362
362
  .TP
363
363
  .B \fB\-a\fP, \fB\-\-all\fP
364
- Indicates that all environments found at the specified path will be uploaded.
364
+ Use to upload all environments found at the specified path.
365
365
  .UNINDENT
366
366
  .sp
367
367
  \fBExamples\fP
@@ -413,7 +413,7 @@ This argument has the following options:
413
413
  .INDENT 0.0
414
414
  .TP
415
415
  .B \fB\-w\fP, \fB\-\-with\-uri\fP
416
- Indicates that the corresponding URIs will be shown.
416
+ Use to show the corresponding URIs.
417
417
  .UNINDENT
418
418
  .sp
419
419
  \fBExamples\fP