RubyGems - chef - Versions diffs - 11.10.0.rc.0 → 11.10.0.rc.1 - Mend

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

Files changed (401) hide show

data/Rakefile +0 -75
data/distro/common/html/_sources/ctl_chef_client.txt +36 -0
data/distro/common/html/_sources/ctl_chef_server.txt +26 -0
data/distro/common/html/_sources/ctl_chef_shell.txt +15 -0
data/distro/common/html/_sources/ctl_chef_solo.txt +25 -0
data/distro/common/html/_sources/index.txt +126 -0
data/distro/common/html/_sources/knife.txt +74 -0
data/distro/common/html/_sources/knife_bootstrap.txt +56 -0
data/distro/common/html/_sources/knife_client.txt +151 -0
data/distro/common/html/_sources/knife_common_options.txt +6 -0
data/distro/common/html/_sources/knife_configure.txt +29 -0
data/distro/common/html/_sources/knife_cookbook.txt +236 -0
data/distro/common/html/_sources/knife_cookbook_site.txt +157 -0
data/distro/common/html/_sources/knife_data_bag.txt +160 -0
data/distro/common/html/_sources/knife_delete.txt +26 -0
data/distro/common/html/_sources/knife_deps.txt +61 -0
data/distro/common/html/_sources/knife_diff.txt +34 -0
data/distro/common/html/_sources/knife_download.txt +44 -0
data/distro/common/html/_sources/knife_edit.txt +26 -0
data/distro/common/html/_sources/knife_environment.txt +158 -0
data/distro/common/html/_sources/knife_exec.txt +47 -0
data/distro/common/html/_sources/knife_index_rebuild.txt +21 -0
data/distro/common/html/_sources/knife_list.txt +33 -0
data/distro/common/html/_sources/knife_node.txt +250 -0
data/distro/common/html/_sources/knife_raw.txt +35 -0
data/distro/common/html/_sources/knife_recipe_list.txt +23 -0
data/distro/common/html/_sources/knife_role.txt +157 -0
data/distro/common/html/_sources/knife_search.txt +53 -0
data/distro/common/html/_sources/knife_show.txt +27 -0
data/distro/common/html/_sources/knife_ssh.txt +43 -0
data/distro/common/html/_sources/knife_status.txt +37 -0
data/distro/common/html/_sources/knife_tag.txt +69 -0
data/distro/common/html/_sources/knife_upload.txt +49 -0
data/distro/common/html/_sources/knife_user.txt +127 -0
data/distro/common/html/_sources/knife_using.txt +43 -0
data/distro/common/html/_sources/knife_xargs.txt +30 -0
data/distro/common/html/_static/ajax-loader.gif +0 -0
data/distro/common/html/_static/basic.css +540 -0
data/distro/common/html/_static/chef.css +507 -0
data/distro/common/html/_static/chef.ico +0 -0
data/distro/common/html/_static/chef_html_logo.png +0 -0
data/distro/common/html/_static/chef_logo.png +0 -0
data/distro/common/html/_static/comment-bright.png +0 -0
data/distro/common/html/_static/comment-close.png +0 -0
data/distro/common/html/_static/comment.png +0 -0
data/distro/common/html/_static/contents.png +0 -0
data/distro/common/html/_static/doctools.js +247 -0
data/distro/common/html/_static/down-pressed.png +0 -0
data/distro/common/html/_static/down.png +0 -0
data/distro/common/html/_static/file.png +0 -0
data/distro/common/html/_static/guide.css +505 -0
data/distro/common/html/_static/jquery.js +154 -0
data/distro/common/html/_static/minus.png +0 -0
data/distro/common/html/_static/navigation.png +0 -0
data/distro/common/html/_static/plus.png +0 -0
data/distro/common/html/_static/pygments.css +62 -0
data/distro/common/html/_static/searchtools.js +560 -0
data/distro/common/html/_static/underscore.js +23 -0
data/distro/common/html/_static/up-pressed.png +0 -0
data/distro/common/html/_static/up.png +0 -0
data/distro/common/html/_static/websupport.js +808 -0
data/distro/common/html/ctl_chef_client.html +219 -0
data/distro/common/html/ctl_chef_server.html +111 -0
data/distro/common/html/ctl_chef_shell.html +120 -0
data/distro/common/html/ctl_chef_solo.html +144 -0
data/distro/common/html/index.html +185 -0
data/distro/common/html/knife.html +172 -0
data/distro/common/html/knife_bootstrap.html +250 -0
data/distro/common/html/knife_client.html +283 -0
data/distro/common/html/knife_common_options.html +98 -0
data/distro/common/html/knife_configure.html +107 -0
data/distro/common/html/knife_cookbook.html +481 -0
data/distro/common/html/knife_cookbook_site.html +372 -0
data/distro/common/html/knife_data_bag.html +359 -0
data/distro/common/html/knife_delete.html +95 -0
data/distro/common/html/knife_deps.html +145 -0
data/distro/common/html/knife_diff.html +125 -0
data/distro/common/html/knife_download.html +147 -0
data/distro/common/html/knife_edit.html +91 -0
data/distro/common/html/knife_environment.html +328 -0
data/distro/common/html/knife_exec.html +222 -0
data/distro/common/html/knife_index_rebuild.html +85 -0
data/distro/common/html/knife_list.html +116 -0
data/distro/common/html/knife_node.html +450 -0
data/distro/common/html/knife_raw.html +112 -0
data/distro/common/html/knife_recipe_list.html +93 -0
data/distro/common/html/knife_role.html +295 -0
data/distro/common/html/knife_search.html +204 -0
data/distro/common/html/knife_show.html +106 -0
data/distro/common/html/knife_ssh.html +179 -0
data/distro/common/html/knife_status.html +142 -0
data/distro/common/html/knife_tag.html +140 -0
data/distro/common/html/knife_upload.html +155 -0
data/distro/common/html/knife_user.html +244 -0
data/distro/common/html/knife_using.html +211 -0
data/distro/common/html/knife_xargs.html +115 -0
data/distro/common/html/objects.inv +0 -0
data/distro/common/html/search.html +84 -0
data/distro/common/html/searchindex.js +1 -0
data/distro/common/man/man1/chef-shell.1 +5 -5
data/distro/common/man/man1/knife-bootstrap.1 +6 -9
data/distro/common/man/man1/knife-client.1 +1 -9
data/distro/common/man/man1/knife-configure.1 +10 -6
data/distro/common/man/man1/knife-cookbook-site.1 +1 -9
data/distro/common/man/man1/knife-cookbook.1 +11 -21
data/distro/common/man/man1/knife-data-bag.1 +8 -22
data/distro/common/man/man1/knife-delete.1 +1 -1
data/distro/common/man/man1/knife-deps.1 +4 -12
data/distro/common/man/man1/knife-diff.1 +1 -1
data/distro/common/man/man1/knife-download.1 +2 -2
data/distro/common/man/man1/knife-edit.1 +1 -1
data/distro/common/man/man1/knife-environment.1 +108 -9
data/distro/common/man/man1/knife-exec.1 +1 -15
data/distro/common/man/man1/knife-index-rebuild.1 +1 -1
data/distro/common/man/man1/knife-list.1 +1 -1
data/distro/common/man/man1/knife-node.1 +3 -13
data/distro/common/man/man1/knife-raw.1 +1 -1
data/distro/common/man/man1/knife-recipe-list.1 +1 -1
data/distro/common/man/man1/knife-role.1 +2 -12
data/distro/common/man/man1/knife-search.1 +5 -5
data/distro/common/man/man1/knife-show.1 +1 -3
data/distro/common/man/man1/knife-ssh.1 +1 -5
data/distro/common/man/man1/knife-status.1 +1 -1
data/distro/common/man/man1/knife-tag.1 +1 -9
data/distro/common/man/man1/knife-upload.1 +7 -9
data/distro/common/man/man1/knife-user.1 +3 -17
data/distro/common/man/man1/knife-xargs.1 +1 -3
data/distro/common/man/man8/chef-client.8 +18 -18
data/distro/common/man/man8/chef-solo.8 +12 -6
data/lib/chef/client.rb +9 -5
data/lib/chef/cookbook_uploader.rb +1 -1
data/lib/chef/dsl/recipe.rb +119 -38
data/lib/chef/exceptions.rb +4 -0
data/lib/chef/policy_builder/expand_node_object.rb +11 -4
data/lib/chef/policy_builder/policyfile.rb +7 -1
data/lib/chef/provider/file.rb +1 -0
data/lib/chef/resource_platform_map.rb +1 -1
data/lib/chef/resource_reporter.rb +2 -2
data/lib/chef/version.rb +1 -1
data/spec/functional/knife/cookbook_delete_spec.rb +9 -9
data/spec/functional/knife/ssh_spec.rb +1 -1
data/spec/functional/resource/link_spec.rb +6 -6
data/spec/functional/resource/registry_spec.rb +7 -7
data/spec/functional/run_lock_spec.rb +1 -1
data/spec/integration/knife/download_spec.rb +1 -1
data/spec/integration/solo/solo_spec.rb +1 -1
data/spec/spec_helper.rb +0 -1
data/spec/stress/win32/file_spec.rb +6 -0
data/spec/support/lib/chef/resource/zen_master.rb +1 -1
data/spec/support/mock/platform.rb +1 -1
data/spec/support/shared/functional/file_resource.rb +0 -2
data/spec/support/shared/functional/securable_resource.rb +2 -2
data/spec/support/shared/unit/api_error_inspector.rb +7 -7
data/spec/support/shared/unit/provider/file.rb +47 -8
data/spec/support/shared/unit/provider/useradd_based_user_provider.rb +23 -23
data/spec/unit/api_client/registration_spec.rb +5 -5
data/spec/unit/api_client_spec.rb +2 -2
data/spec/unit/application/apply.rb +6 -6
data/spec/unit/application/client_spec.rb +6 -6
data/spec/unit/application/knife_spec.rb +5 -5
data/spec/unit/application/solo_spec.rb +13 -13
data/spec/unit/application_spec.rb +19 -19
data/spec/unit/checksum/storage/filesystem_spec.rb +2 -2
data/spec/unit/client_spec.rb +23 -23
data/spec/unit/config_spec.rb +4 -4
data/spec/unit/cookbook/metadata_spec.rb +22 -22
data/spec/unit/cookbook/synchronizer_spec.rb +17 -17
data/spec/unit/daemon_spec.rb +21 -22
data/spec/unit/data_bag_item_spec.rb +8 -8
data/spec/unit/data_bag_spec.rb +6 -6
data/spec/unit/deprecation_spec.rb +1 -1
data/spec/unit/dsl/data_query_spec.rb +1 -1
data/spec/unit/environment_spec.rb +5 -5
data/spec/unit/file_access_control_spec.rb +5 -5
data/spec/unit/file_cache_spec.rb +1 -1
data/spec/unit/file_content_management/deploy/mv_unix_spec.rb +1 -1
data/spec/unit/file_content_management/deploy/mv_windows_spec.rb +12 -12
data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +4 -4
data/spec/unit/formatters/error_inspectors/cookbook_resolve_error_inspector_spec.rb +4 -4
data/spec/unit/formatters/error_inspectors/cookbook_sync_error_inspector_spec.rb +1 -1
data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +6 -6
data/spec/unit/formatters/error_inspectors/run_list_expansion_error_inspector_spec.rb +4 -4
data/spec/unit/handler/json_file_spec.rb +1 -1
data/spec/unit/handler_spec.rb +3 -3
data/spec/unit/knife/bootstrap_spec.rb +17 -17
data/spec/unit/knife/client_bulk_delete_spec.rb +4 -4
data/spec/unit/knife/client_create_spec.rb +7 -7
data/spec/unit/knife/client_reregister_spec.rb +2 -2
data/spec/unit/knife/client_show_spec.rb +1 -1
data/spec/unit/knife/config_file_selection_spec.rb +4 -4
data/spec/unit/knife/configure_client_spec.rb +4 -4
data/spec/unit/knife/configure_spec.rb +16 -16
data/spec/unit/knife/cookbook_bulk_delete_spec.rb +10 -10
data/spec/unit/knife/cookbook_create_spec.rb +5 -5
data/spec/unit/knife/cookbook_delete_spec.rb +6 -6
data/spec/unit/knife/cookbook_download_spec.rb +10 -10
data/spec/unit/knife/cookbook_list_spec.rb +3 -3
data/spec/unit/knife/cookbook_metadata_from_file_spec.rb +2 -2
data/spec/unit/knife/cookbook_metadata_spec.rb +8 -8
data/spec/unit/knife/cookbook_show_spec.rb +4 -4
data/spec/unit/knife/cookbook_site_download_spec.rb +3 -3
data/spec/unit/knife/cookbook_site_install_spec.rb +8 -8
data/spec/unit/knife/cookbook_site_share_spec.rb +22 -22
data/spec/unit/knife/cookbook_site_unshare_spec.rb +8 -8
data/spec/unit/knife/cookbook_test_spec.rb +7 -7
data/spec/unit/knife/cookbook_upload_spec.rb +20 -20
data/spec/unit/knife/core/cookbook_scm_repo_spec.rb +6 -6
data/spec/unit/knife/core/object_loader_spec.rb +1 -1
data/spec/unit/knife/core/ui_spec.rb +19 -21
data/spec/unit/knife/data_bag_create_spec.rb +4 -4
data/spec/unit/knife/data_bag_edit_spec.rb +7 -7
data/spec/unit/knife/data_bag_from_file_spec.rb +15 -15
data/spec/unit/knife/data_bag_show_spec.rb +5 -5
data/spec/unit/knife/environment_create_spec.rb +6 -6
data/spec/unit/knife/environment_delete_spec.rb +6 -6
data/spec/unit/knife/environment_edit_spec.rb +5 -5
data/spec/unit/knife/environment_from_file_spec.rb +7 -7
data/spec/unit/knife/environment_list_spec.rb +4 -4
data/spec/unit/knife/environment_show_spec.rb +4 -4
data/spec/unit/knife/index_rebuild_spec.rb +2 -2
data/spec/unit/knife/knife_help.rb +11 -11
data/spec/unit/knife/node_bulk_delete_spec.rb +4 -4
data/spec/unit/knife/node_delete_spec.rb +5 -5
data/spec/unit/knife/node_edit_spec.rb +2 -2
data/spec/unit/knife/node_from_file_spec.rb +5 -5
data/spec/unit/knife/node_list_spec.rb +3 -3
data/spec/unit/knife/node_run_list_add_spec.rb +3 -3
data/spec/unit/knife/node_run_list_remove_spec.rb +4 -4
data/spec/unit/knife/node_run_list_set_spec.rb +5 -5
data/spec/unit/knife/node_show_spec.rb +2 -2
data/spec/unit/knife/role_bulk_delete_spec.rb +4 -4
data/spec/unit/knife/role_create_spec.rb +5 -5
data/spec/unit/knife/role_delete_spec.rb +5 -5
data/spec/unit/knife/role_edit_spec.rb +5 -5
data/spec/unit/knife/role_from_file_spec.rb +5 -5
data/spec/unit/knife/role_list_spec.rb +2 -2
data/spec/unit/knife/ssh_spec.rb +6 -6
data/spec/unit/knife/status_spec.rb +4 -4
data/spec/unit/knife/tag_create_spec.rb +3 -3
data/spec/unit/knife/tag_delete_spec.rb +3 -3
data/spec/unit/knife/tag_list_spec.rb +2 -2
data/spec/unit/knife/user_create_spec.rb +7 -7
data/spec/unit/knife/user_reregister_spec.rb +3 -3
data/spec/unit/knife/user_show_spec.rb +1 -1
data/spec/unit/knife_spec.rb +29 -29
data/spec/unit/lwrp_spec.rb +2 -2
data/spec/unit/mixin/checksum_spec.rb +2 -2
data/spec/unit/mixin/command_spec.rb +1 -1
data/spec/unit/mixin/enforce_ownership_and_permissions_spec.rb +4 -4
data/spec/unit/mixin/params_validate_spec.rb +17 -17
data/spec/unit/mixin/path_sanity_spec.rb +8 -8
data/spec/unit/mixin/securable_spec.rb +87 -87
data/spec/unit/mixin/shell_out_spec.rb +1 -1
data/spec/unit/mixin/template_spec.rb +2 -2
data/spec/unit/node/attribute_spec.rb +3 -3
data/spec/unit/node_spec.rb +12 -12
data/spec/unit/platform_spec.rb +1 -1
data/spec/unit/policy_builder/expand_node_object_spec.rb +16 -0
data/spec/unit/policy_builder/policyfile_spec.rb +4 -0
data/spec/unit/provider/breakpoint_spec.rb +8 -8
data/spec/unit/provider/cookbook_file/content_spec.rb +4 -4
data/spec/unit/provider/cookbook_file_spec.rb +1 -1
data/spec/unit/provider/cron/unix_spec.rb +11 -11
data/spec/unit/provider/cron_spec.rb +40 -40
data/spec/unit/provider/deploy/revision_spec.rb +11 -12
data/spec/unit/provider/deploy/timestamped_spec.rb +3 -3
data/spec/unit/provider/deploy_spec.rb +50 -50
data/spec/unit/provider/directory_spec.rb +18 -18
data/spec/unit/provider/env_spec.rb +15 -15
data/spec/unit/provider/erl_call_spec.rb +1 -1
data/spec/unit/provider/execute_spec.rb +5 -5
data/spec/unit/provider/file/content_spec.rb +5 -5
data/spec/unit/provider/file_spec.rb +1 -1
data/spec/unit/provider/git_spec.rb +47 -47
data/spec/unit/provider/group/dscl_spec.rb +16 -15
data/spec/unit/provider/group/gpasswd_spec.rb +6 -5
data/spec/unit/provider/group/groupadd_spec.rb +10 -10
data/spec/unit/provider/group/groupmod_spec.rb +3 -3
data/spec/unit/provider/group/pw_spec.rb +9 -8
data/spec/unit/provider/group/usermod_spec.rb +13 -12
data/spec/unit/provider/group/windows_spec.rb +9 -9
data/spec/unit/provider/group_spec.rb +31 -31
data/spec/unit/provider/http_request_spec.rb +3 -3
data/spec/unit/provider/ifconfig/aix_spec.rb +7 -7
data/spec/unit/provider/ifconfig/debian_spec.rb +3 -3
data/spec/unit/provider/ifconfig/redhat_spec.rb +5 -5
data/spec/unit/provider/ifconfig_spec.rb +13 -13
data/spec/unit/provider/link_spec.rb +33 -33
data/spec/unit/provider/mdadm_spec.rb +4 -4
data/spec/unit/provider/mount/aix_spec.rb +5 -5
data/spec/unit/provider/mount/mount_spec.rb +49 -50
data/spec/unit/provider/mount/windows_spec.rb +18 -18
data/spec/unit/provider/mount_spec.rb +12 -12
data/spec/unit/provider/ohai_spec.rb +6 -6
data/spec/unit/provider/package/aix_spec.rb +14 -14
data/spec/unit/provider/package/apt_spec.rb +10 -10
data/spec/unit/provider/package/dpkg_spec.rb +13 -13
data/spec/unit/provider/package/easy_install_spec.rb +6 -6
data/spec/unit/provider/package/freebsd_spec.rb +29 -29
data/spec/unit/provider/package/ips_spec.rb +4 -4
data/spec/unit/provider/package/macports_spec.rb +6 -6
data/spec/unit/provider/package/pacman_spec.rb +17 -17
data/spec/unit/provider/package/portage_spec.rb +18 -18
data/spec/unit/provider/package/rpm_spec.rb +7 -7
data/spec/unit/provider/package/rubygems_spec.rb +31 -31
data/spec/unit/provider/package/smartos_spec.rb +4 -4
data/spec/unit/provider/package/solaris_spec.rb +15 -15
data/spec/unit/provider/package/yum_spec.rb +100 -100
data/spec/unit/provider/package/zypper_spec.rb +10 -10
data/spec/unit/provider/package_spec.rb +21 -21
data/spec/unit/provider/registry_key_spec.rb +2 -2
data/spec/unit/provider/remote_file/content_spec.rb +31 -31
data/spec/unit/provider/remote_file/fetcher_spec.rb +8 -8
data/spec/unit/provider/remote_file/ftp_spec.rb +10 -10
data/spec/unit/provider/remote_file/http_spec.rb +4 -4
data/spec/unit/provider/remote_file/local_file_spec.rb +2 -2
data/spec/unit/provider/remote_file_spec.rb +1 -1
data/spec/unit/provider/route_spec.rb +23 -23
data/spec/unit/provider/script_spec.rb +5 -5
data/spec/unit/provider/service/arch_service_spec.rb +41 -41
data/spec/unit/provider/service/debian_service_spec.rb +23 -23
data/spec/unit/provider/service/freebsd_service_spec.rb +33 -33
data/spec/unit/provider/service/gentoo_service_spec.rb +16 -16
data/spec/unit/provider/service/init_service_spec.rb +13 -13
data/spec/unit/provider/service/insserv_service_spec.rb +4 -4
data/spec/unit/provider/service/invokercd_service_spec.rb +12 -12
data/spec/unit/provider/service/macosx_spec.rb +20 -20
data/spec/unit/provider/service/redhat_spec.rb +15 -15
data/spec/unit/provider/service/simple_service_spec.rb +9 -9
data/spec/unit/provider/service/solaris_smf_service_spec.rb +13 -13
data/spec/unit/provider/service/systemd_service_spec.rb +28 -28
data/spec/unit/provider/service/upstart_service_spec.rb +41 -41
data/spec/unit/provider/service/windows_spec.rb +37 -37
data/spec/unit/provider/service_spec.rb +9 -9
data/spec/unit/provider/subversion_spec.rb +36 -36
data/spec/unit/provider/template/content_spec.rb +8 -8
data/spec/unit/provider/template_spec.rb +1 -1
data/spec/unit/provider/user/dscl_spec.rb +9 -9
data/spec/unit/provider/user/pw_spec.rb +20 -20
data/spec/unit/provider/user/solaris_spec.rb +5 -5
data/spec/unit/provider/user/windows_spec.rb +8 -8
data/spec/unit/provider/user_spec.rb +34 -34
data/spec/unit/provider_spec.rb +3 -3
data/spec/unit/recipe_spec.rb +79 -4
data/spec/unit/registry_helper_spec.rb +2 -2
data/spec/unit/resource/cron_spec.rb +2 -2
data/spec/unit/resource/directory_spec.rb +5 -5
data/spec/unit/resource/env_spec.rb +2 -2
data/spec/unit/resource/erl_call_spec.rb +1 -1
data/spec/unit/resource/file_spec.rb +8 -8
data/spec/unit/resource/group_spec.rb +3 -3
data/spec/unit/resource/link_spec.rb +8 -8
data/spec/unit/resource/mdadm_spec.rb +3 -3
data/spec/unit/resource/mount_spec.rb +3 -3
data/spec/unit/resource/route_spec.rb +2 -2
data/spec/unit/resource/user_spec.rb +2 -2
data/spec/unit/resource/yum_package_spec.rb +2 -2
data/spec/unit/resource_collection_spec.rb +1 -1
data/spec/unit/resource_definition_spec.rb +2 -2
data/spec/unit/resource_reporter_spec.rb +71 -16
data/spec/unit/resource_spec.rb +3 -3
data/spec/unit/rest/auth_credentials_spec.rb +2 -2
data/spec/unit/rest_spec.rb +3 -40
data/spec/unit/run_list/run_list_expansion_spec.rb +3 -3
data/spec/unit/run_list_spec.rb +9 -9
data/spec/unit/run_status_spec.rb +1 -1
data/spec/unit/runner_spec.rb +8 -8
data/spec/unit/scan_access_control_spec.rb +3 -3
data/spec/unit/search/query_spec.rb +7 -7
data/spec/unit/shell/model_wrapper_spec.rb +2 -2
data/spec/unit/shell/shell_ext_spec.rb +15 -15
data/spec/unit/shell/shell_session_spec.rb +9 -9
data/spec/unit/shell_spec.rb +1 -2
data/spec/unit/user_spec.rb +4 -4
data/spec/unit/util/backup_spec.rb +1 -1
data/spec/unit/util/selinux_spec.rb +7 -7
metadata +106 -51
data/distro/common/html/chef-client.8.html +0 -145
data/distro/common/html/chef-expander.8.html +0 -164
data/distro/common/html/chef-expanderctl.8.html +0 -146
data/distro/common/html/chef-server-webui.8.html +0 -185
data/distro/common/html/chef-server.8.html +0 -182
data/distro/common/html/chef-shell.1.html +0 -286
data/distro/common/html/chef-solo.8.html +0 -185
data/distro/common/html/chef-solr.8.html +0 -165
data/distro/common/html/knife-bootstrap.1.html +0 -241
data/distro/common/html/knife-client.1.html +0 -219
data/distro/common/html/knife-configure.1.html +0 -170
data/distro/common/html/knife-cookbook-site.1.html +0 -241
data/distro/common/html/knife-cookbook.1.html +0 -381
data/distro/common/html/knife-data-bag.1.html +0 -235
data/distro/common/html/knife-environment.1.html +0 -265
data/distro/common/html/knife-exec.1.html +0 -134
data/distro/common/html/knife-index.1.html +0 -125
data/distro/common/html/knife-node.1.html +0 -250
data/distro/common/html/knife-role.1.html +0 -200
data/distro/common/html/knife-search.1.html +0 -288
data/distro/common/html/knife-ssh.1.html +0 -156
data/distro/common/html/knife-status.1.html +0 -128
data/distro/common/html/knife-tag.1.html +0 -137
data/distro/common/html/knife.1.html +0 -315

data/distro/common/html/knife_cookbook_site.html ADDED

@@ -0,0 +1,372 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>knife cookbook site &mdash; chef-client Man Pages</title>
+    <link rel="stylesheet" href="_static/guide.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '',
+        VERSION:     '',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <link rel="shortcut icon" href="_static/chef.ico"/>
+  </head>
+  <body>
+<div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
+<a href="http://docs.opscode.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
+</div>
+    <div class="document">
+      <div class="documentwrapper">
+          <div class="body">
+  <div class="section" id="knife-cookbook-site">
+<h1>knife cookbook site<a class="headerlink" href="#knife-cookbook-site" title="Permalink to this headline">¶</a></h1>
+<p>The Cookbooks Site API is used to provide access to the cookbooks community hosted at <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a>. All of the cookbooks in the community are accessible through a REST API located at <a class="reference external" href="https://cookbooks.opscode.com/api/v1/">https://cookbooks.opscode.com/api/v1/</a> by using any of the supported endpoints. In most cases, using Knife and the <strong>knife cookbook site</strong> sub-command (and any of its arguments) is the recommended method of interacting with these cookbooks, but in some cases, using the REST API directly may make sense.</p>
+<p>The <strong>knife cookbook site</strong> subcommand is used to interact with cookbooks that are located at <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a>. A user account is required for any community actions that write data to this site. The following arguments do not require a user account: <tt class="docutils literal"><span class="pre">download</span></tt>, <tt class="docutils literal"><span class="pre">search</span></tt>, <tt class="docutils literal"><span class="pre">install</span></tt>, and <tt class="docutils literal"><span class="pre">list</span></tt>.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) Knife subcommands and plugins.</p>
+</div>
+<div class="section" id="download">
+<h2>download<a class="headerlink" href="#download" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">download</span></tt> argument is used to download a cookbook from the community website. A cookbook will be downloaded as a tar.gz archive and placed in the current working directory. If a cookbook (or cookbook version) has been deprecated and the <tt class="docutils literal"><span class="pre">--force</span></tt> option is not used, Knife will alert the user that the cookbook is deprecated and then will provide the name of the most recent non-deprecated version of that cookbook.</p>
+<div class="section" id="syntax">
+<h3>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site download COOKBOOK_NAME <span class="o">[</span>COOKBOOK_VERSION<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="options">
+<h3>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">COOKBOOK_VERSION</span></tt></dt>
+<dd>The version of a cookbook to be downloaded. If a cookbook has only one version, this option does not need to be specified. If a cookbook has more than one version and this option is not specified, Knife will prompt for a version.</dd>
+<dt><tt class="docutils literal"><span class="pre">-f</span></tt>, <tt class="docutils literal"><span class="pre">--force</span></tt></dt>
+<dd>Indicates that an existing directory will be overwritten.</dd>
+</dl>
+</div>
+<div class="section" id="examples">
+<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Download a cookbook</strong></p>
+<p>To download the cookbook &#8220;getting-started&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site download getting-started
+</pre></div>
+</div>
+<p>to return something like:</p>
+<div class="highlight-bash"><div class="highlight"><pre>Downloading getting-started from the cookbooks site at version 0.3.0 to
+  /Users/sdanna/opscodesupport/getting-started-0.3.0.tar.gz
+Cookbook saved: /Users/sdanna/opscodesupport/getting-started-0.3.0.tar.gz
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="install">
+<h2>install<a class="headerlink" href="#install" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">install</span></tt> argument is used to install a cookbook that has been downloaded from the community site to a local git repository . This action uses the git version control system in conjunction with the <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a> site to install community-contributed cookbooks to the local chef-repo. Using this argument does the following:</p>
+<blockquote>
+<div><ol class="arabic simple">
+<li>A new &#8220;pristine copy&#8221; branch is created in git for tracking the upstream.</li>
+<li>All existing versions of a cookbook are removed from the branch.</li>
+<li>The cookbook is downloaded from <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a> in the tar.gz format.</li>
+<li>The downloaded cookbook is untarred and its contents are committed to git and a tag is created.</li>
+<li>The &#8220;pristine copy&#8221; branch is merged into the master branch.</li>
+</ol>
+</div></blockquote>
+<p>This process allows the upstream cookbook in the master branch to be modified while letting git maintain changes as a separate patch. When an updated upstream version becomes available, those changes can be merged while maintaining any local modifications.</p>
+<div class="section" id="id1">
+<h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site install COOKBOOK_NAME <span class="o">[</span>COOKBOOK_VERSION<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id2">
+<h3>Options<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-b</span></tt>, <tt class="docutils literal"><span class="pre">--use-current-branch</span></tt></dt>
+<dd>Indicates that the current branch will be used.</dd>
+<dt><tt class="docutils literal"><span class="pre">-B</span> <span class="pre">BRANCH</span></tt>, <tt class="docutils literal"><span class="pre">--branch</span> <span class="pre">BRANCH</span></tt></dt>
+<dd>The name of the default branch. This will default to the master branch.</dd>
+<dt><tt class="docutils literal"><span class="pre">COOKBOOK_VERSION</span></tt></dt>
+<dd>The version of the cookbook to be installed. If a version is not specified, the most recent version of the cookbook will be installed.</dd>
+<dt><tt class="docutils literal"><span class="pre">-D</span></tt>, <tt class="docutils literal"><span class="pre">--skip-dependencies</span></tt></dt>
+<dd>Indicates that all cookbooks to which the installed cookbook has a dependency will not be installed.</dd>
+<dt><tt class="docutils literal"><span class="pre">-o</span> <span class="pre">PATH:PATH</span></tt>, <tt class="docutils literal"><span class="pre">--cookbook-path</span> <span class="pre">PATH:PATH</span></tt></dt>
+<dd>The directory in which cookbook are created. This can be a colon-separated path.</dd>
+</dl>
+</div>
+<div class="section" id="id3">
+<h3>Examples<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Install a cookbook</strong></p>
+<p>To install the cookbook &#8220;getting-started&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site install getting-started
+</pre></div>
+</div>
+<p>to return something like:</p>
+<div class="highlight-bash"><div class="highlight"><pre>Installing getting-started to /Users/sdanna/opscodesupport/.chef/../cookbooks
+Checking out the master branch.
+Creating pristine copy branch chef-vendor-getting-started
+Downloading getting-started from the cookbooks site at version 0.3.0 to
+  /Users/sdanna/opscodesupport/.chef/../cookbooks/getting-started.tar.gz
+Cookbook saved: /Users/sdanna/opscodesupport/.chef/../cookbooks/getting-started.tar.gz
+Removing pre-existing version.
+Uncompressing getting-started version /Users/sdanna/opscodesupport/.chef/../cookbooks.
+removing downloaded tarball
+1 files updated, committing changes
+Creating tag cookbook-site-imported-getting-started-0.3.0
+Checking out the master branch.
+Updating 4d44b5b..b4c32f2
+Fast-forward
+ cookbooks/getting-started/README.rdoc              |    4 +++
+ cookbooks/getting-started/attributes/default.rb    |    1 +
+ cookbooks/getting-started/metadata.json            |   29 ++++++++++++++++++++
+ cookbooks/getting-started/metadata.rb              |    6 ++++
+ cookbooks/getting-started/recipes/default.rb       |   23 +++++++++++++++
+ .../templates/default/chef-getting-started.txt.erb |    5 +++
+ 6 files changed, 68 insertions<span class="o">(</span>+<span class="o">)</span>, 0 deletions<span class="o">(</span>-<span class="o">)</span>
+ create mode 100644 cookbooks/getting-started/README.rdoc
+ create mode 100644 cookbooks/getting-started/attributes/default.rb
+ create mode 100644 cookbooks/getting-started/metadata.json
+ create mode 100644 cookbooks/getting-started/metadata.rb
+ create mode 100644 cookbooks/getting-started/recipes/default.rb
+ create mode 100644 cookbooks/getting-started/templates/default/chef-getting-started.txt.erb
+Cookbook getting-started version 0.3.0 successfully installed
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="list">
+<h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view a list of cookbooks that are currently available at <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a>.</p>
+<div class="section" id="id4">
+<h3>Syntax<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site list
+</pre></div>
+</div>
+</div>
+<div class="section" id="id5">
+<h3>Options<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
+<dd>Indicates that the corresponding URIs will be shown.</dd>
+</dl>
+</div>
+<div class="section" id="id6">
+<h3>Examples<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>View a list of cookbooks</strong></p>
+<p>To view a list of cookbooks at <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a> server, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site list
+</pre></div>
+</div>
+<p>to return:</p>
+<div class="highlight-python"><pre>1password             homesick              rabbitmq
+7-zip                 hostname              rabbitmq-management
+AmazonEC2Tag          hosts                 rabbitmq_chef
+R                     hosts-awareness       rackspaceknife
+accounts              htop                  radiant
+ack-grep              hudson                rails
+activemq              icinga                rails_enterprise
+ad                    id3lib                redis-package
+ad-likewise           iftop                 redis2
+ant                   iis                   redmine
+[...truncated...]</pre>
+</div>
+</div>
+</div>
+<div class="section" id="search">
+<h2>search<a class="headerlink" href="#search" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">search</span></tt> argument is used to search for a cookbook at <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a>. A search query is used to return a list of cookbooks at <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a> and uses the same syntax as the <strong>knife search</strong> sub-command.</p>
+<div class="section" id="id7">
+<h3>Syntax<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site search SEARCH_QUERY <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id8">
+<h3>Options<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h3>
+<p>This command does not have any specific options.</p>
+</div>
+<div class="section" id="id9">
+<h3>Examples<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Search for cookbooks</strong></p>
+<p>To search for all of the cookbooks that can be used with Apache, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site search apache*
+</pre></div>
+</div>
+<p>to return something like:</p>
+<div class="highlight-bash"><div class="highlight"><pre>apache2:
+  cookbook:              http://cookbooks.opscode.com/api/v1/cookbooks/apache2
+  cookbook_description:  Installs and configures apache2 using Debian symlinks with helper definitions
+  cookbook_maintainer:   opscode
+  cookbook_name:         apache2
+instiki:
+  cookbook:              http://cookbooks.opscode.com/api/v1/cookbooks/instiki
+  cookbook_description:  Installs instiki, a Ruby on Rails wiki server under passenger+Apache2.
+  cookbook_maintainer:   jtimberman
+  cookbook_name:         instiki
+kickstart:
+  cookbook:              http://cookbooks.opscode.com/api/v1/cookbooks/kickstart
+  cookbook_description:  Creates apache2 vhost and serves a kickstart file.
+  cookbook_maintainer:   opscode
+  cookbook_name:         kickstart
+<span class="o">[</span>...truncated...<span class="o">]</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="share">
+<h2>share<a class="headerlink" href="#share" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">share</span></tt> argument is used to add a cookbook to <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a>. This action will require a user account and a certificate for <a class="reference external" href="http://community.opscode.com">http://community.opscode.com</a>. By default, Knife will use the user name and API key that is identified in the configuration file used during the upload; otherwise these values must be specified on the command line or in an alternate configuration file. If a cookbook already exists on <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a>, then only an owner or maintainer of that cookbook can make updates.</p>
+<div class="section" id="id10">
+<h3>Syntax<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site share COOKBOOK_NAME CATEGORY <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id11">
+<h3>Options<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">CATEGORY</span></tt></dt>
+<dd>The cookbook category: <tt class="docutils literal"><span class="pre">Databases</span></tt>, <tt class="docutils literal"><span class="pre">Web</span> <span class="pre">Servers</span></tt>, <tt class="docutils literal"><span class="pre">Process</span> <span class="pre">Management</span></tt>, <tt class="docutils literal"><span class="pre">Monitoring</span> <span class="pre">and</span> <span class="pre">Trending</span></tt>, <tt class="docutils literal"><span class="pre">Programming</span> <span class="pre">Languages</span></tt>, <tt class="docutils literal"><span class="pre">Package</span> <span class="pre">Management</span></tt>, <tt class="docutils literal"><span class="pre">Applications</span></tt>, <tt class="docutils literal"><span class="pre">Networking</span></tt>, <tt class="docutils literal"><span class="pre">Operations</span> <span class="pre">Systems</span> <span class="pre">and</span> <span class="pre">Virtualization</span></tt>, <tt class="docutils literal"><span class="pre">Utilities</span></tt>, or <tt class="docutils literal"><span class="pre">Other</span></tt>.</dd>
+<dt><tt class="docutils literal"><span class="pre">-o</span> <span class="pre">PATH:PATH</span></tt>, <tt class="docutils literal"><span class="pre">--cookbook-path</span> <span class="pre">PATH:PATH</span></tt></dt>
+<dd>The directory in which cookbook are created. This can be a colon-separated path.</dd>
+</dl>
+</div>
+<div class="section" id="id12">
+<h3>Examples<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Share a cookbook</strong></p>
+<p>To share a cookbook named &#8220;apache2&#8221;:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site share <span class="s2">&quot;apache2&quot;</span> <span class="s2">&quot;Web Servers&quot;</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="show">
+<h2>show<a class="headerlink" href="#show" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">show</span></tt> argument is used to view information about a cookbook on <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a>.</p>
+<div class="section" id="id13">
+<h3>Syntax<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site show COOKBOOK_NAME <span class="o">[</span>COOKBOOK_VERSION<span class="o">]</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id14">
+<h3>Options<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">COOKBOOK_VERSION</span></tt></dt>
+<dd>The version of a cookbook to be shown. If a cookbook has only one version, this option does not need to be specified. If a cookbook has more than one version and this option is not specified, a list of cookbook versions will be returned.</dd>
+</dl>
+</div>
+<div class="section" id="id15">
+<h3>Examples<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Show cookbook data</strong></p>
+<p>To show the details for a cookbook named &#8220;haproxy&#8221;:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site show haproxy
+</pre></div>
+</div>
+<p>to return something like:</p>
+<div class="highlight-bash"><div class="highlight"><pre>average_rating:
+category:        Networking
+created_at:      2009-10-25T23:51:07Z
+description:     Installs and configures haproxy
+external_url:
+latest_version:  http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_3
+maintainer:      opscode
+name:            haproxy
+updated_at:      2011-06-30T21:53:25Z
+versions:
+   http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_3
+   http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_2
+   http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_1
+   http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_0
+   http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/0_8_1
+   http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/0_8_0
+   http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/0_7_0
+</pre></div>
+</div>
+<p><strong>Show cookbook data as JSON</strong></p>
+<p>To view information in JSON format, use the <tt class="docutils literal"><span class="pre">-F</span></tt> common option as part of the command like this:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife role show devops -F json
+</pre></div>
+</div>
+<p>Other formats available include <tt class="docutils literal"><span class="pre">text</span></tt>, <tt class="docutils literal"><span class="pre">yaml</span></tt>, and <tt class="docutils literal"><span class="pre">pp</span></tt>.</p>
+</div>
+</div>
+<div class="section" id="unshare">
+<h2>unshare<a class="headerlink" href="#unshare" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">unshare</span></tt> argument is used to stop the sharing of a cookbook at <a class="reference external" href="https://cookbooks.opscode.com">https://cookbooks.opscode.com</a>. Only the maintainer of a cookbook may perform this action.</p>
+<div class="section" id="id16">
+<h3>Syntax<a class="headerlink" href="#id16" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site unshare COOKBOOK_NAME
+</pre></div>
+</div>
+</div>
+<div class="section" id="id17">
+<h3>Options<a class="headerlink" href="#id17" title="Permalink to this headline">¶</a></h3>
+<p>This command does not have any specific options.</p>
+</div>
+<div class="section" id="id18">
+<h3>Examples<a class="headerlink" href="#id18" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Unshare a cookbook</strong></p>
+<p>To unshare a cookbook named &#8220;getting-started&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife cookbook site unshare getting-started
+</pre></div>
+</div>
+</div>
+</div>
+</div>
+          </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+  </body>
+</html>

data/distro/common/html/knife_data_bag.html ADDED

@@ -0,0 +1,359 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>knife data bag &mdash; chef-client Man Pages</title>
+    <link rel="stylesheet" href="_static/guide.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '',
+        VERSION:     '',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <link rel="shortcut icon" href="_static/chef.ico"/>
+  </head>
+  <body>
+<div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
+<a href="http://docs.opscode.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
+</div>
+    <div class="document">
+      <div class="documentwrapper">
+          <div class="body">
+  <div class="section" id="knife-data-bag">
+<h1>knife data bag<a class="headerlink" href="#knife-data-bag" title="Permalink to this headline">¶</a></h1>
+<p>A data bag is a global variable that is stored as JSON data and is accessible from a server. A data bag is indexed for searching and can be loaded by a recipe or accessed during a search. The contents of a data bag can vary, but they often include sensitive information (such as database passwords).</p>
+<p>A data bag item may be encrypted using <a class="reference external" href="https://en.wikipedia.org/wiki/Symmetric-key_algorithm">shared secret encryption</a>. This allows each data bag item to store confidential information (such as a database password) or to be managed in a source control system (without plain-text data appearing in revision history). Each data bag item may be encrypted individually; if a data bag contains multiple encrypted data bag items, these data bag items are not required to share the same encryption keys.</p>
+<p>The <strong>knife data bag</strong> subcommand is used to manage arbitrary stores of globally available JSON data.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) Knife subcommands and plugins.</p>
+</div>
+<div class="section" id="create">
+<h2>create<a class="headerlink" href="#create" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to add a data bag to the server.</p>
+<div class="section" id="syntax">
+<h3>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag create DATA_BAG_NAME <span class="o">[</span>DATA_BAG_ITEM<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="options">
+<h3>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">DATA_BAG_ITEM</span></tt></dt>
+<dd>The name of a specific item within a data bag.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret</span> <span class="pre">SECRET</span></tt></dt>
+<dd>The encryption key that is used for values contained within a data bag item.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret-file</span> <span class="pre">FILE</span></tt></dt>
+<dd>The path to the file that contains the encryption key.</dd>
+</dl>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">For encrypted data bag items, use <em>either</em> <tt class="docutils literal"><span class="pre">--secret</span></tt> or <tt class="docutils literal"><span class="pre">--secret-file</span></tt>, not both.</p>
+</div>
+</div>
+<div class="section" id="examples">
+<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Create a data bag</strong></p>
+<p>To create a data bag named &#8220;admins&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag create admins
+</pre></div>
+</div>
+<p>to return:</p>
+<div class="highlight-bash"><div class="highlight"><pre>Created data_bag<span class="o">[</span>admins<span class="o">]</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="delete">
+<h2>delete<a class="headerlink" href="#delete" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a data bag or a data bag item from a server.</p>
+<div class="section" id="id1">
+<h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag delete DATA_BAG_NAME <span class="o">[</span>DATA_BAG_ITEM<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id2">
+<h3>Options<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">DATA_BAG_ITEM</span></tt></dt>
+<dd>The name of a specific item within a data bag.</dd>
+</dl>
+</div>
+<div class="section" id="id3">
+<h3>Examples<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Delete a data bag</strong></p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag delete data_bag_name
+</pre></div>
+</div>
+<p><strong>Delete a data bag item</strong></p>
+<p>To delete an item named &#8220;charlie&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag delete admins charlie
+</pre></div>
+</div>
+<p>Type <tt class="docutils literal"><span class="pre">Y</span></tt> to confirm a deletion.</p>
+</div>
+</div>
+<div class="section" id="edit">
+<h2>edit<a class="headerlink" href="#edit" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the data contained in a data bag. If encryption is being used, the data bag will be decrypted, the data will be made available in the $EDITOR, and then encrypted again before saving it to the server.</p>
+<div class="section" id="id4">
+<h3>Syntax<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag edit DATA_BAG_NAME <span class="o">[</span>DATA_BAG_ITEM<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id5">
+<h3>Options<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">DATA_BAG_ITEM</span></tt></dt>
+<dd>The name of a specific item within a data bag.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret</span> <span class="pre">SECRET</span></tt></dt>
+<dd>The encryption key that is used for values contained within a data bag item.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret-file</span> <span class="pre">FILE</span></tt></dt>
+<dd>The path to the file that contains the encryption key.</dd>
+</dl>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">For encrypted data bag items, use <em>either</em> <tt class="docutils literal"><span class="pre">--secret</span></tt> or <tt class="docutils literal"><span class="pre">--secret-file</span></tt>, not both.</p>
+</div>
+</div>
+<div class="section" id="id6">
+<h3>Examples<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Edit a data bag</strong></p>
+<p>To edit the contents of a data bag, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag edit admins
+</pre></div>
+</div>
+<p><strong>Edit a data bag item</strong></p>
+<p>To edit an item named &#8220;charlie&#8221; that is contained in a data bag named &#8220;admins&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag edit admins charlie
+</pre></div>
+</div>
+<p>to open the $EDITOR. Once opened, you can update the data before saving it to the server. For example, by changing:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="o">{</span>
+   <span class="s2">&quot;id&quot;</span>: <span class="s2">&quot;charlie&quot;</span>
+<span class="o">}</span>
+</pre></div>
+</div>
+<p>to:</p>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
+   <span class="s2">&quot;id&quot;</span><span class="o">:</span> <span class="s2">&quot;charlie&quot;</span><span class="p">,</span>
+   <span class="s2">&quot;uid&quot;</span><span class="o">:</span> <span class="mi">1005</span><span class="p">,</span>
+   <span class="s2">&quot;gid&quot;</span><span class="o">:</span><span class="s2">&quot;ops&quot;</span><span class="p">,</span>
+   <span class="s2">&quot;shell&quot;</span><span class="o">:</span><span class="s2">&quot;/bin/zsh&quot;</span><span class="p">,</span>
+   <span class="s2">&quot;comment&quot;</span><span class="o">:</span><span class="s2">&quot;Crazy Charlie&quot;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="from-file">
+<h2>from file<a class="headerlink" href="#from-file" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">from</span> <span class="pre">file</span></tt> argument is used to create a data bag on the server from a file. The path to the data bag file must specify one of the following:</p>
+<ul class="simple">
+<li>the name of a data bag</li>
+<li>a relative or absolute path to a file</li>
+</ul>
+<p>If the name of a data bag is specified, Knife will search for the data bag in <tt class="docutils literal"><span class="pre">./data_bags/bag_name/file</span></tt>. 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.</p>
+<div class="admonition warning">
+<p class="first admonition-title">Warning</p>
+<p class="last">A chef-client must be version 11.6 (or higher) when using the <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">from</span> <span class="pre">file</span></tt> argument with the Enterprise Chef or Open Source Chef version 11 servers.</p>
+</div>
+<div class="section" id="id7">
+<h3>Syntax<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag from file DATA_BAG_NAME_or_PATH
+</pre></div>
+</div>
+</div>
+<div class="section" id="id8">
+<h3>Options<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--all</span></tt></dt>
+<dd>Indicates that all data bags found at the specified path will be uploaded.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret</span> <span class="pre">SECRET</span></tt></dt>
+<dd>The encryption key that is used for values contained within a data bag item.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret-file</span> <span class="pre">FILE</span></tt></dt>
+<dd>The path to the file that contains the encryption key.</dd>
+</dl>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">For encrypted data bag items, use <em>either</em> <tt class="docutils literal"><span class="pre">--secret</span></tt> or <tt class="docutils literal"><span class="pre">--secret-file</span></tt>, not both.</p>
+</div>
+</div>
+<div class="section" id="id9">
+<h3>Examples<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Create a data bag from a file</strong></p>
+<p>To create a data bag on the server from a file:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag from file <span class="s2">&quot;path to JSON file&quot;</span>
+</pre></div>
+</div>
+<p><strong>Create an encrypted data bag from a file</strong></p>
+<p>To create a data bag named &#8220;devops_data&#8221; that contains encrypted data, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag from file devops_data --secret-file <span class="s2">&quot;path to decryption file&quot;</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="list">
+<h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view a list of data bags that are currently available on the server.</p>
+<div class="section" id="id10">
+<h3>Syntax<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag list
+</pre></div>
+</div>
+</div>
+<div class="section" id="id11">
+<h3>Options<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
+<dd>Indicates that the corresponding URIs will be shown.</dd>
+</dl>
+</div>
+<div class="section" id="id12">
+<h3>Examples<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>View a list of data bags</strong></p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag list
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="show">
+<h2>show<a class="headerlink" href="#show" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">show</span></tt> argument is used to view the contents of a data bag.</p>
+<div class="section" id="id13">
+<h3>Syntax<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag show DATA_BAG_NAME <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id14">
+<h3>Options<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">DATA_BAG_ITEM</span></tt></dt>
+<dd>The name of a specific item within a data bag.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret</span> <span class="pre">SECRET</span></tt></dt>
+<dd>The encryption key that is used for values contained within a data bag item.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret-file</span> <span class="pre">FILE</span></tt></dt>
+<dd>The path to the file that contains the encryption key.</dd>
+</dl>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">For encrypted data bag items, use <em>either</em> <tt class="docutils literal"><span class="pre">--secret</span></tt> or <tt class="docutils literal"><span class="pre">--secret-file</span></tt>, not both.</p>
+</div>
+</div>
+<div class="section" id="id15">
+<h3>Examples<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Show a data bag</strong></p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag show admins
+</pre></div>
+</div>
+<p>to return something like:</p>
+<div class="highlight-bash"><div class="highlight"><pre>charlie
+</pre></div>
+</div>
+<p><strong>Show a data bag item</strong></p>
+<p>To show the contents of a specific item within data bag, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag show admins charlie
+</pre></div>
+</div>
+<p>to return:</p>
+<div class="highlight-bash"><div class="highlight"><pre>comment:  Crazy Charlie
+gid:      ops
+id:       charlie
+shell:    /bin/zsh
+uid:      1005
+</pre></div>
+</div>
+<p><strong>Show a data bag, encrypted</strong></p>
+<p>To show the contents of a data bag named &#8220;passwords&#8221; with an item that contains encrypted data named &#8220;mysql&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag show passwords mysql
+</pre></div>
+</div>
+<p>to return:</p>
+<div class="highlight-javascript"><pre>## sample:
+{
+  "id": "mysql",
+  "pass": "trywgFA6R70NO28PNhMpGhEvKBZuxouemnbnAUQsUyo=\n",
+  "user": "e/p+8WJYVHY9fHcEgAAReg==\n"
+}</pre>
+</div>
+<p><strong>Show a data bag, decrypted</strong></p>
+<p>To show the decrypted contents of the same data bag, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag show --secret-file /path/to/decryption/file passwords mysql
+</pre></div>
+</div>
+<p>to return:</p>
+<div class="highlight-javascript"><pre>## sample:
+{
+   "id": "mysql",
+   "pass": "thesecret123",
+   "user": "fred"
+}</pre>
+</div>
+<p><strong>Show a data bag as JSON</strong></p>
+<p>To view information in JSON format, use the <tt class="docutils literal"><span class="pre">-F</span></tt> common option as part of the command like this:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag show admins -F json
+</pre></div>
+</div>
+<p>Other formats available include <tt class="docutils literal"><span class="pre">text</span></tt>, <tt class="docutils literal"><span class="pre">yaml</span></tt>, and <tt class="docutils literal"><span class="pre">pp</span></tt>.</p>
+</div>
+</div>
+</div>
+          </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+  </body>
+</html>