chef 11.10.0.alpha.1 → 11.10.0.rc.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (131) hide show
  1. data/README.md +57 -36
  2. data/distro/common/html/chef-client.8.html +4 -4
  3. data/distro/common/html/chef-expander.8.html +4 -4
  4. data/distro/common/html/chef-expanderctl.8.html +4 -4
  5. data/distro/common/html/chef-server-webui.8.html +4 -4
  6. data/distro/common/html/chef-server.8.html +4 -4
  7. data/distro/common/html/chef-shell.1.html +4 -4
  8. data/distro/common/html/chef-solo.8.html +4 -4
  9. data/distro/common/html/chef-solr.8.html +5 -5
  10. data/distro/common/html/knife-bootstrap.1.html +4 -4
  11. data/distro/common/html/knife-client.1.html +4 -4
  12. data/distro/common/html/knife-configure.1.html +4 -4
  13. data/distro/common/html/knife-cookbook-site.1.html +4 -4
  14. data/distro/common/html/knife-cookbook.1.html +4 -4
  15. data/distro/common/html/knife-data-bag.1.html +4 -4
  16. data/distro/common/html/knife-environment.1.html +4 -4
  17. data/distro/common/html/knife-exec.1.html +4 -4
  18. data/distro/common/html/knife-index.1.html +4 -4
  19. data/distro/common/html/knife-node.1.html +4 -4
  20. data/distro/common/html/knife-role.1.html +4 -4
  21. data/distro/common/html/knife-search.1.html +4 -4
  22. data/distro/common/html/knife-ssh.1.html +4 -4
  23. data/distro/common/html/knife-status.1.html +4 -4
  24. data/distro/common/html/knife-tag.1.html +4 -4
  25. data/distro/common/html/knife.1.html +4 -4
  26. data/distro/common/man/man1/knife-bootstrap.1 +58 -64
  27. data/distro/common/man/man1/knife-client.1 +19 -22
  28. data/distro/common/man/man1/knife-configure.1 +37 -46
  29. data/distro/common/man/man1/knife-cookbook-site.1 +14 -17
  30. data/distro/common/man/man1/knife-cookbook.1 +15 -18
  31. data/distro/common/man/man1/knife-data-bag.1 +14 -17
  32. data/distro/common/man/man1/knife-delete.1 +38 -47
  33. data/distro/common/man/man1/knife-deps.1 +39 -48
  34. data/distro/common/man/man1/knife-diff.1 +43 -52
  35. data/distro/common/man/man1/knife-download.1 +47 -53
  36. data/distro/common/man/man1/knife-edit.1 +32 -41
  37. data/distro/common/man/man1/knife-environment.1 +14 -17
  38. data/distro/common/man/man1/knife-exec.1 +52 -61
  39. data/distro/common/man/man1/knife-index-rebuild.1 +1 -61
  40. data/distro/common/man/man1/knife-list.1 +47 -59
  41. data/distro/common/man/man1/knife-node.1 +15 -18
  42. data/distro/common/man/man1/knife-raw.1 +28 -46
  43. data/distro/common/man/man1/knife-recipe-list.1 +1 -61
  44. data/distro/common/man/man1/knife-role.1 +19 -25
  45. data/distro/common/man/man1/knife-search.1 +53 -62
  46. data/distro/common/man/man1/knife-show.1 +36 -28
  47. data/distro/common/man/man1/knife-ssh.1 +55 -61
  48. data/distro/common/man/man1/knife-status.1 +34 -43
  49. data/distro/common/man/man1/knife-tag.1 +14 -17
  50. data/distro/common/man/man1/knife-upload.1 +47 -56
  51. data/distro/common/man/man1/knife-user.1 +17 -20
  52. data/distro/common/man/man1/knife-xargs.1 +60 -69
  53. data/lib/chef/application.rb +3 -1
  54. data/lib/chef/application/windows_service.rb +0 -1
  55. data/lib/chef/client.rb +41 -152
  56. data/lib/chef/config.rb +19 -23
  57. data/lib/chef/data_bag.rb +1 -1
  58. data/lib/chef/data_bag_item.rb +1 -1
  59. data/lib/chef/exceptions.rb +8 -0
  60. data/lib/chef/formatters/doc.rb +15 -0
  61. data/lib/chef/formatters/error_inspectors/api_error_formatting.rb +2 -1
  62. data/lib/chef/http.rb +18 -8
  63. data/lib/chef/http/authenticator.rb +4 -0
  64. data/lib/chef/http/cookie_manager.rb +3 -0
  65. data/lib/chef/http/decompressor.rb +4 -0
  66. data/lib/chef/http/json_input.rb +4 -0
  67. data/lib/chef/http/json_output.rb +4 -0
  68. data/lib/chef/http/validate_content_length.rb +94 -0
  69. data/lib/chef/knife.rb +0 -1
  70. data/lib/chef/knife/configure.rb +6 -6
  71. data/lib/chef/knife/cookbook_create.rb +2 -2
  72. data/lib/chef/knife/core/subcommand_loader.rb +49 -3
  73. data/lib/chef/knife/ssh.rb +34 -4
  74. data/lib/chef/mixin/path_sanity.rb +1 -0
  75. data/lib/chef/monologger.rb +1 -2
  76. data/lib/chef/node.rb +7 -0
  77. data/lib/chef/policy_builder.rb +49 -0
  78. data/lib/chef/policy_builder/expand_node_object.rb +230 -0
  79. data/lib/chef/policy_builder/policyfile.rb +338 -0
  80. data/lib/chef/provider/file.rb +15 -5
  81. data/lib/chef/provider/group.rb +6 -2
  82. data/lib/chef/provider/group/windows.rb +12 -2
  83. data/lib/chef/provider/http_request.rb +3 -2
  84. data/lib/chef/provider/package.rb +1 -0
  85. data/lib/chef/provider/package/aix.rb +1 -1
  86. data/lib/chef/provider/service/debian.rb +7 -2
  87. data/lib/chef/resource/file.rb +8 -1
  88. data/lib/chef/resource/package.rb +9 -0
  89. data/lib/chef/resource/service.rb +0 -1
  90. data/lib/chef/rest.rb +2 -0
  91. data/lib/chef/run_context.rb +1 -1
  92. data/lib/chef/util/file_edit.rb +1 -1
  93. data/lib/chef/util/windows/net_group.rb +7 -6
  94. data/lib/chef/version.rb +1 -1
  95. data/lib/chef/win32/version.rb +31 -18
  96. data/spec/data/cookbooks/preseed/templates/default/preseed-template-variables.seed +1 -0
  97. data/spec/functional/resource/file_spec.rb +0 -1
  98. data/spec/functional/resource/group_spec.rb +96 -16
  99. data/spec/functional/resource/package_spec.rb +17 -0
  100. data/spec/functional/resource/user_spec.rb +2 -2
  101. data/spec/functional/win32/versions_spec.rb +39 -0
  102. data/spec/integration/client/client_spec.rb +27 -28
  103. data/spec/spec_helper.rb +2 -0
  104. data/spec/support/platform_helpers.rb +7 -1
  105. data/spec/support/shared/functional/file_resource.rb +83 -43
  106. data/spec/unit/application_spec.rb +7 -5
  107. data/spec/unit/client_spec.rb +10 -3
  108. data/spec/unit/config_spec.rb +0 -30
  109. data/spec/unit/cookbook_spec.rb +1 -0
  110. data/spec/unit/data_bag_item_spec.rb +8 -0
  111. data/spec/unit/data_bag_spec.rb +6 -0
  112. data/spec/unit/http_spec.rb +48 -0
  113. data/spec/unit/knife/core/subcommand_loader_spec.rb +77 -1
  114. data/spec/unit/knife/ssh_spec.rb +107 -0
  115. data/spec/unit/mixin/path_sanity_spec.rb +6 -0
  116. data/spec/unit/mixin/securable_spec.rb +77 -3
  117. data/spec/unit/monologger_spec.rb +45 -0
  118. data/spec/unit/node_spec.rb +16 -0
  119. data/spec/unit/policy_builder/expand_node_object_spec.rb +320 -0
  120. data/spec/unit/policy_builder/policyfile_spec.rb +399 -0
  121. data/spec/unit/policy_builder_spec.rb +26 -0
  122. data/spec/unit/provider/deploy_spec.rb +3 -0
  123. data/spec/unit/provider/group/windows_spec.rb +1 -0
  124. data/spec/unit/provider/http_request_spec.rb +23 -1
  125. data/spec/unit/provider/service/debian_service_spec.rb +50 -19
  126. data/spec/unit/recipe_spec.rb +4 -0
  127. data/spec/unit/resource/package_spec.rb +5 -0
  128. data/spec/unit/rest_spec.rb +375 -278
  129. data/spec/unit/run_context_spec.rb +4 -0
  130. metadata +96 -59
  131. checksums.yaml +0 -7
@@ -33,16 +33,35 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
33
33
  .sp
34
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).
35
35
  .sp
36
- \fBCommon Options\fP
36
+ \fBSyntax\fP
37
+ .sp
38
+ This argument has the following syntax:
39
+ .sp
40
+ .nf
41
+ .ft C
42
+ $ knife edit (options)
43
+ .ft P
44
+ .fi
45
+ .sp
46
+ \fBOptions\fP
37
47
  .sp
38
- The following options can be run with all Knife sub\-commands and plug\-ins:
48
+ This subcommand has the following options:
39
49
  .INDENT 0.0
40
50
  .TP
41
- .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
51
+ .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
42
52
  The configuration file to use.
43
53
  .TP
44
- .B \fB\-\-color\fP
45
- Indicates that colored output will be used.
54
+ .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.
56
+ .TP
57
+ .B \fB\-\-chef\-zero\-port PORT\fP
58
+ The port on which chef\-zero will listen.
59
+ .TP
60
+ .B \fB\-\-[no\-]color\fP
61
+ Indicates whether colored output will be used.
62
+ .TP
63
+ .B \fB\-\-concurrency\fP
64
+ The number of allowed concurrent connections. Default: \fB10\fP.
46
65
  .TP
47
66
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
48
67
  Indicates that $EDITOR will not be opened; data will be accepted as\-is.
@@ -56,9 +75,6 @@ The $EDITOR that is used for all interactive commands.
56
75
  .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
57
76
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
58
77
  .TP
59
- .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
60
- Indicates that the private key will be saved to a specified file name.
61
- .TP
62
78
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
63
79
  The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
64
80
  .TP
@@ -68,15 +84,15 @@ Shows help for the command.
68
84
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
69
85
  The private key that Knife will use to sign requests made by the API client to the server.
70
86
  .TP
71
- .B \fB\-\-no\-color\fP
72
- Indicates that color will not be used in the output.
73
- .TP
74
- .B \fB\-p PASSWORD\fP, \fB\-\-password PASSWORD\fP
75
- The user password.
87
+ .B \fB\-\-local\fP
88
+ Use to show files in the local chef\-repo instead of a remote location. Default: \fBfalse\fP.
76
89
  .TP
77
90
  .B \fB\-\-print\-after\fP
78
91
  Indicates that data will be shown after a destructive operation.
79
92
  .TP
93
+ .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.
95
+ .TP
80
96
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
81
97
  The URL for the server.
82
98
  .TP
@@ -91,36 +107,11 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
91
107
  .TP
92
108
  .B \fB\-y\fP, \fB\-\-yes\fP
93
109
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
94
- .UNINDENT
95
- .sp
96
- \fBSyntax\fP
97
- .sp
98
- This argument has the following syntax:
99
- .sp
100
- .nf
101
- .ft C
102
- $ knife edit (options)
103
- .ft P
104
- .fi
105
- .sp
106
- \fBOptions\fP
107
- .sp
108
- This subcommand has the following options:
109
- .INDENT 0.0
110
110
  .TP
111
- .B \fB\-\-chef\-repo\-path PATH\fP
112
- 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.
113
- .TP
114
- .B \fB\-\-concurrency\fP
115
- The number of allowed concurrent connections. Default: \fB10\fP.
116
- .TP
117
- .B \fB\-\-local\fP
118
- Use to show files in the local chef\-repo instead of a remote location. Default: \fBfalse\fP.
119
- .TP
120
- .B \fB\-\-repo\-mode MODE\fP
121
- 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.
111
+ .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.
122
113
  .UNINDENT
123
114
  .SH AUTHOR
124
- Opscode
115
+ Chef
125
116
  .\" Generated by docutils manpage writer.
126
117
  .
@@ -44,14 +44,14 @@ $ knife environment [ARGUMENT] (options)
44
44
  .fi
45
45
  .SH COMMON OPTIONS
46
46
  .sp
47
- The following options can be run with all Knife sub\-commands and plug\-ins:
47
+ The following options may be used with any of the arguments available to the \fBknife environment\fP subcommand:
48
48
  .INDENT 0.0
49
49
  .TP
50
- .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
51
- The configuration file to use.
50
+ .B \fB\-\-chef\-zero\-port PORT\fP
51
+ The port on which chef\-zero will listen.
52
52
  .TP
53
- .B \fB\-\-color\fP
54
- Indicates that colored output will be used.
53
+ .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
54
+ The configuration file to use.
55
55
  .TP
56
56
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
57
57
  Indicates that $EDITOR will not be opened; data will be accepted as\-is.
@@ -65,9 +65,6 @@ The $EDITOR that is used for all interactive commands.
65
65
  .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
66
66
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
67
67
  .TP
68
- .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
69
- Indicates that the private key will be saved to a specified file name.
70
- .TP
71
68
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
72
69
  The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
73
70
  .TP
@@ -77,11 +74,8 @@ Shows help for the command.
77
74
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
78
75
  The private key that Knife will use to sign requests made by the API client to the server.
79
76
  .TP
80
- .B \fB\-\-no\-color\fP
81
- Indicates that color will not be used in the output.
82
- .TP
83
- .B \fB\-p PASSWORD\fP, \fB\-\-password PASSWORD\fP
84
- The user password.
77
+ .B \fB\-\-[no\-]color\fP
78
+ Indicates whether colored output will be used.
85
79
  .TP
86
80
  .B \fB\-\-print\-after\fP
87
81
  Indicates that data will be shown after a destructive operation.
@@ -92,14 +86,17 @@ The URL for the server.
92
86
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
93
87
  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.
94
88
  .TP
95
- .B \fB\-v\fP, \fB\-\-version\fP
96
- The version of the chef\-client.
97
- .TP
98
89
  .B \fB\-V\fP, \fB\-\-verbose\fP
99
90
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
100
91
  .TP
92
+ .B \fB\-v\fP, \fB\-\-version\fP
93
+ The version of the chef\-client.
94
+ .TP
101
95
  .B \fB\-y\fP, \fB\-\-yes\fP
102
96
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
97
+ .TP
98
+ .B \fB\-z\fP, \fB\-\-local\-mode\fP
99
+ 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.
103
100
  .UNINDENT
104
101
  .SH CREATE
105
102
  .sp
@@ -319,6 +316,6 @@ $ knife role show devops \-F json
319
316
  .sp
320
317
  Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP.
321
318
  .SH AUTHOR
322
- Opscode
319
+ Chef
323
320
  .\" Generated by docutils manpage writer.
324
321
  .
@@ -47,66 +47,6 @@ When the chef\-shell DSL is available, the chef\-client DSL will not be (unless
47
47
  .UNINDENT
48
48
  .UNINDENT
49
49
  .sp
50
- \fBCommon Options\fP
51
- .sp
52
- The following options can be run with all Knife sub\-commands and plug\-ins:
53
- .INDENT 0.0
54
- .TP
55
- .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
56
- The configuration file to use.
57
- .TP
58
- .B \fB\-\-color\fP
59
- Indicates that colored output will be used.
60
- .TP
61
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
62
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
63
- .TP
64
- .B \fB\-\-defaults\fP
65
- Indicates that Knife will use the default value, instead of asking a user to provide one.
66
- .TP
67
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
68
- The $EDITOR that is used for all interactive commands.
69
- .TP
70
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
71
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
72
- .TP
73
- .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
74
- Indicates that the private key will be saved to a specified file name.
75
- .TP
76
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
77
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
78
- .TP
79
- .B \fB\-h\fP, \fB\-\-help\fP
80
- Shows help for the command.
81
- .TP
82
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
83
- The private key that Knife will use to sign requests made by the API client to the server.
84
- .TP
85
- .B \fB\-\-no\-color\fP
86
- Indicates that color will not be used in the output.
87
- .TP
88
- .B \fB\-p PASSWORD\fP, \fB\-\-password PASSWORD\fP
89
- The user password.
90
- .TP
91
- .B \fB\-\-print\-after\fP
92
- Indicates that data will be shown after a destructive operation.
93
- .TP
94
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
95
- The URL for the server.
96
- .TP
97
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
98
- 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.
99
- .TP
100
- .B \fB\-v\fP, \fB\-\-version\fP
101
- The version of the chef\-client.
102
- .TP
103
- .B \fB\-V\fP, \fB\-\-verbose\fP
104
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
105
- .TP
106
- .B \fB\-y\fP, \fB\-\-yes\fP
107
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
108
- .UNINDENT
109
- .sp
110
50
  \fBAuthenticated API Requests\fP
111
51
  .sp
112
52
  The \fBknife exec\fP subcommand can be used to make authenticated API requests to the server using the following methods:
@@ -209,11 +149,62 @@ $ knife exec SCRIPT (options)
209
149
  This subcommand has the following options:
210
150
  .INDENT 0.0
211
151
  .TP
152
+ .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
153
+ The configuration file to use.
154
+ .TP
155
+ .B \fB\-\-chef\-zero\-port PORT\fP
156
+ The port on which chef\-zero will listen.
157
+ .TP
158
+ .B \fB\-\-[no\-]color\fP
159
+ Indicates whether colored output will be used.
160
+ .TP
161
+ .B \fB\-d\fP, \fB\-\-disable\-editing\fP
162
+ Indicates that $EDITOR will not be opened; data will be accepted as\-is.
163
+ .TP
164
+ .B \fB\-\-defaults\fP
165
+ Indicates that Knife will use the default value, instead of asking a user to provide one.
166
+ .TP
212
167
  .B \fB\-E CODE\fP, \fB\-\-exec CODE\fP
213
168
  A string of code that will be executed.
214
169
  .TP
170
+ .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
171
+ The $EDITOR that is used for all interactive commands.
172
+ .TP
173
+ .B \fB\-\-environment ENVIRONMENT\fP
174
+ The name of the environment. When this option is added to a command, the command will run only against the named environment.
175
+ .TP
176
+ .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
177
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
178
+ .TP
179
+ .B \fB\-h\fP, \fB\-\-help\fP
180
+ Shows help for the command.
181
+ .TP
182
+ .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
183
+ The private key that Knife will use to sign requests made by the API client to the server.
184
+ .TP
215
185
  .B \fB\-p PATH:PATH\fP, \fB\-\-script\-path PATH:PATH\fP
216
186
  A colon\-separated path at which Ruby scripts are located.
187
+ .TP
188
+ .B \fB\-\-print\-after\fP
189
+ Indicates that data will be shown after a destructive operation.
190
+ .TP
191
+ .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
192
+ The URL for the server.
193
+ .TP
194
+ .B \fB\-u USER\fP, \fB\-\-user USER\fP
195
+ 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.
196
+ .TP
197
+ .B \fB\-v\fP, \fB\-\-version\fP
198
+ The version of the chef\-client.
199
+ .TP
200
+ .B \fB\-V\fP, \fB\-\-verbose\fP
201
+ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
202
+ .TP
203
+ .B \fB\-y\fP, \fB\-\-yes\fP
204
+ Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
205
+ .TP
206
+ .B \fB\-z\fP, \fB\-\-local\-mode\fP
207
+ 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.
217
208
  .UNINDENT
218
209
  .sp
219
210
  \fBExamples\fP
@@ -320,6 +311,6 @@ Your attributes: ipaddress fqdn
320
311
  .ft P
321
312
  .fi
322
313
  .SH AUTHOR
323
- Opscode
314
+ Chef
324
315
  .\" Generated by docutils manpage writer.
325
316
  .
@@ -36,66 +36,6 @@ The \fBknife index rebuild\fP subcommand is used to rebuild the search indexes f
36
36
  This subcommand ONLY works when run against the open source server version 10.x. This subcommand will NOT run against open source server 11, Enterprise Chef (including hosted Enterprise Chef), or Private Chef.
37
37
  .RE
38
38
  .sp
39
- \fBCommon Options\fP
40
- .sp
41
- The following options can be run with all Knife sub\-commands and plug\-ins:
42
- .INDENT 0.0
43
- .TP
44
- .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
45
- The configuration file to use.
46
- .TP
47
- .B \fB\-\-color\fP
48
- Indicates that colored output will be used.
49
- .TP
50
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
51
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
52
- .TP
53
- .B \fB\-\-defaults\fP
54
- Indicates that Knife will use the default value, instead of asking a user to provide one.
55
- .TP
56
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
57
- The $EDITOR that is used for all interactive commands.
58
- .TP
59
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
60
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
61
- .TP
62
- .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
63
- Indicates that the private key will be saved to a specified file name.
64
- .TP
65
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
66
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
67
- .TP
68
- .B \fB\-h\fP, \fB\-\-help\fP
69
- Shows help for the command.
70
- .TP
71
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
72
- The private key that Knife will use to sign requests made by the API client to the server.
73
- .TP
74
- .B \fB\-\-no\-color\fP
75
- Indicates that color will not be used in the output.
76
- .TP
77
- .B \fB\-p PASSWORD\fP, \fB\-\-password PASSWORD\fP
78
- The user password.
79
- .TP
80
- .B \fB\-\-print\-after\fP
81
- Indicates that data will be shown after a destructive operation.
82
- .TP
83
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
84
- The URL for the server.
85
- .TP
86
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
87
- 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.
88
- .TP
89
- .B \fB\-v\fP, \fB\-\-version\fP
90
- The version of the chef\-client.
91
- .TP
92
- .B \fB\-V\fP, \fB\-\-verbose\fP
93
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
94
- .TP
95
- .B \fB\-y\fP, \fB\-\-yes\fP
96
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
97
- .UNINDENT
98
- .sp
99
39
  \fBSyntax\fP
100
40
  .sp
101
41
  This argument has the following syntax:
@@ -110,6 +50,6 @@ $ knife index rebuild
110
50
  .sp
111
51
  This command does not have any specific options.
112
52
  .SH AUTHOR
113
- Opscode
53
+ Chef
114
54
  .\" Generated by docutils manpage writer.
115
55
  .
@@ -33,31 +33,56 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
33
33
  .sp
34
34
  The \fBknife list\fP subcommand is used to view a list of objects on the server. This subcommand works similar to \fBknife cookbook list\fP, \fBknife data bag list\fP, \fBknife environment list\fP, \fBknife node list\fP, and \fBknife role list\fP, but with a single verb (and a single action).
35
35
  .sp
36
- \fBCommon Options\fP
36
+ \fBSyntax\fP
37
+ .sp
38
+ This argument has the following syntax:
39
+ .sp
40
+ .nf
41
+ .ft C
42
+ $ knife list [PATTERN...] (options)
43
+ .ft P
44
+ .fi
45
+ .sp
46
+ \fBOptions\fP
37
47
  .sp
38
- The following options can be run with all Knife sub\-commands and plug\-ins:
48
+ This subcommand has the following options:
39
49
  .INDENT 0.0
40
50
  .TP
41
- .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
51
+ .B \fB\-1\fP
52
+ Indicates that only one column of results will be shown. Default: \fBfalse\fP.
53
+ .TP
54
+ .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
42
55
  The configuration file to use.
43
56
  .TP
44
- .B \fB\-\-color\fP
45
- Indicates that colored output will be used.
57
+ .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.
59
+ .TP
60
+ .B \fB\-\-chef\-zero\-port PORT\fP
61
+ The port on which chef\-zero will listen.
46
62
  .TP
47
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
48
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
63
+ .B \fB\-\-[no\-]color\fP
64
+ Indicates whether colored output will be used.
65
+ .TP
66
+ .B \fB\-\-concurrency\fP
67
+ The number of allowed concurrent connections. Default: \fB10\fP.
68
+ .TP
69
+ .B \fB\-d\fP
70
+ Indicates that a directory\(aqs children will not be shown when a directory matches a pattern. Default value: \fBfalse\fP.
49
71
  .TP
50
72
  .B \fB\-\-defaults\fP
51
73
  Indicates that Knife will use the default value, instead of asking a user to provide one.
52
74
  .TP
75
+ .B \fB\-\-disable\-editing\fP
76
+ Indicates that $EDITOR will not be opened; data will be accepted as\-is.
77
+ .TP
53
78
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
54
79
  The $EDITOR that is used for all interactive commands.
55
80
  .TP
56
81
  .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
57
82
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
58
83
  .TP
59
- .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
60
- Indicates that the private key will be saved to a specified file name.
84
+ .B \fB\-f\fP, \fB\-\-flat\fP
85
+ Indicates that a list of file names will be shown. Set to \fBfalse\fP to view ls\-like output. Default: \fBfalse\fP.
61
86
  .TP
62
87
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
63
88
  The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
@@ -68,15 +93,21 @@ Shows help for the command.
68
93
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
69
94
  The private key that Knife will use to sign requests made by the API client to the server.
70
95
  .TP
71
- .B \fB\-\-no\-color\fP
72
- Indicates that color will not be used in the output.
96
+ .B \fB\-\-local\fP
97
+ Indicates that only contents of the local directory will be returned. Default: \fBfalse\fP.
73
98
  .TP
74
- .B \fB\-p PASSWORD\fP, \fB\-\-password PASSWORD\fP
75
- The user password.
99
+ .B \fB\-p\fP
100
+ Indicates that trailing slashes (/) will be shown for directories. Default: \fBfalse\fP.
76
101
  .TP
77
102
  .B \fB\-\-print\-after\fP
78
103
  Indicates that data will be shown after a destructive operation.
79
104
  .TP
105
+ .B \fB\-R\fP
106
+ Indicates that directories will be listed recursively. Default: \fBfalse\fP.
107
+ .TP
108
+ .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.
110
+ .TP
80
111
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
81
112
  The URL for the server.
82
113
  .TP
@@ -91,52 +122,9 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
91
122
  .TP
92
123
  .B \fB\-y\fP, \fB\-\-yes\fP
93
124
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
94
- .UNINDENT
95
- .sp
96
- \fBSyntax\fP
97
- .sp
98
- This argument has the following syntax:
99
- .sp
100
- .nf
101
- .ft C
102
- $ knife list [PATTERN...] (options)
103
- .ft P
104
- .fi
105
- .sp
106
- \fBOptions\fP
107
- .sp
108
- This subcommand has the following options:
109
- .INDENT 0.0
110
- .TP
111
- .B \fB\-1\fP
112
- Indicates that only one results column will be shown.
113
- .TP
114
- .B \fB\-\-chef\-repo\-path PATH\fP
115
- 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.
116
- .TP
117
- .B \fB\-\-concurrency\fP
118
- The number of allowed concurrent connections. Default: \fB10\fP.
119
125
  .TP
120
- .B \fB\-d\fP
121
- Indicates that a directory\(aqs children will not be shown when a directory matches a pattern. Default value: \fBfalse\fP.
122
- .TP
123
- .B \fB\-f\fP, \fB\-\-flat\fP
124
- Indicates that a list of file names will be shown. Set to \fBfalse\fP to view ls\-like output. Default: \fBfalse\fP.
125
- .TP
126
- .B \fB\-\-local\fP
127
- Indicates that only contents of the local directory will be returned. Default: \fBfalse\fP.
128
- .TP
129
- .B \fB\-1\fP
130
- Indicates that only one column of results will be shown. Default: \fBfalse\fP.
131
- .TP
132
- .B \fB\-p\fP
133
- Indicates that trailing slashes (/) will be shown for directories. Default: \fBfalse\fP.
134
- .TP
135
- .B \fB\-R\fP
136
- Indicates that directories will be listed recursively. Default: \fBfalse\fP.
137
- .TP
138
- .B \fB\-\-repo\-mode MODE\fP
139
- 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.
126
+ .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.
140
128
  .UNINDENT
141
129
  .sp
142
130
  \fBExamples\fP
@@ -165,6 +153,6 @@ $ knife list \-R /
165
153
  .ft P
166
154
  .fi
167
155
  .SH AUTHOR
168
- Opscode
156
+ Chef
169
157
  .\" Generated by docutils manpage writer.
170
158
  .