chef 0.10.4.rc.4 → 0.10.4.rc.5

data/distro/common/html/knife-role.1.html

@@ -177,11 +177,11 @@ run_list.</p>
 
 <h2 id="AUTHOR">AUTHOR</h2>
 
-<p>   Chef was written by Adam Jacob <a href="&#109;&#97;&#x69;&#108;&#x74;&#x6f;&#x3a;&#97;&#100;&#x61;&#109;&#x40;&#x6f;&#x70;&#115;&#99;&#x6f;&#x64;&#101;&#x2e;&#99;&#x6f;&#109;" data-bare-link="true">&#97;&#100;&#97;&#x6d;&#64;&#x6f;&#112;&#x73;&#x63;&#111;&#100;&#101;&#46;&#99;&#x6f;&#109;</a> with many contributions from the community.</p>
+<p>   Chef was written by Adam Jacob <a href="&#x6d;&#97;&#x69;&#108;&#116;&#111;&#58;&#97;&#x64;&#97;&#109;&#64;&#x6f;&#x70;&#x73;&#99;&#111;&#100;&#x65;&#x2e;&#99;&#111;&#x6d;" data-bare-link="true">&#97;&#100;&#97;&#109;&#x40;&#x6f;&#x70;&#115;&#x63;&#x6f;&#x64;&#x65;&#46;&#99;&#x6f;&#109;</a> with many contributions from the community.</p>
 
 <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
 
-<p>   This manual page was written by Joshua Timberman <a href="&#109;&#97;&#x69;&#x6c;&#x74;&#111;&#x3a;&#x6a;&#x6f;&#115;&#x68;&#117;&#x61;&#x40;&#x6f;&#x70;&#x73;&#x63;&#x6f;&#x64;&#101;&#x2e;&#99;&#111;&#x6d;" data-bare-link="true">&#106;&#111;&#x73;&#104;&#x75;&#97;&#x40;&#x6f;&#x70;&#115;&#99;&#x6f;&#100;&#101;&#46;&#99;&#x6f;&#109;</a>.
+<p>   This manual page was written by Joshua Timberman <a href="&#x6d;&#97;&#105;&#x6c;&#x74;&#x6f;&#x3a;&#106;&#x6f;&#x73;&#x68;&#x75;&#x61;&#x40;&#111;&#x70;&#x73;&#99;&#111;&#100;&#101;&#x2e;&#99;&#x6f;&#x6d;" data-bare-link="true">&#106;&#111;&#x73;&#104;&#x75;&#x61;&#x40;&#x6f;&#x70;&#115;&#x63;&#x6f;&#x64;&#x65;&#46;&#99;&#111;&#x6d;</a>.
    Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
 
 <h2 id="CHEF">CHEF</h2>
@@ -190,8 +190,8 @@ run_list.</p>
 
 
   <ol class='man-decor man-foot man foot'>
-    <li class='tl'>Chef 0.10.0</li>
-    <li class='tc'>April 2011</li>
+    <li class='tl'>Chef 0.10.4.rc.5</li>
+    <li class='tc'>August 2011</li>
     <li class='tr'>knife-role(1)</li>
   </ol>
 

data/distro/common/html/knife-search.1.html

@@ -62,8 +62,10 @@
     <a href="#NAME">NAME</a>
     <a href="#SYNOPSIS">SYNOPSIS</a>
     <a href="#DESCRIPTION">DESCRIPTION</a>
-    <a href="#SYNTAX">SYNTAX</a>
+    <a href="#INDEXES">INDEXES</a>
+    <a href="#QUERY-SYNTAX">QUERY SYNTAX</a>
     <a href="#EXAMPLES">EXAMPLES</a>
+    <a href="#KNOWN-BUGS">KNOWN BUGS</a>
     <a href="#SEE-ALSO">SEE ALSO</a>
     <a href="#AUTHOR">AUTHOR</a>
     <a href="#DOCUMENTATION">DOCUMENTATION</a>
@@ -85,46 +87,197 @@
 
 <p><strong>knife</strong> <strong>search INDEX QUERY</strong> <em>(options)</em></p>
 
-<dl>
-<dt><code>-a</code>, <code>--attribute ATTR</code></dt><dd>Show only one attribute</dd>
-<dt><code>-i</code>, <code>--id-only</code></dt><dd>Show only the ID of matching objects</dd>
-<dt><code>-R</code>, <code>--rows INT</code></dt><dd>The number of rows to return</dd>
-<dt><code>-r</code>, <code>--run-list</code></dt><dd>Show only the run list</dd>
-<dt><code>-o</code>, <code>--sort SORT</code></dt><dd>The order to sort the results in</dd>
-<dt><code>-b</code>, <code>--start ROW</code></dt><dd>The row to start returning results at</dd>
-<dt><code>-m</code>, <code>--medium</code></dt><dd>Display medium sized output when searching nodes using the default
-summary format</dd>
-<dt><code>-l</code>, <code>--long</code></dt><dd>Display long output when searching nodes using the default summary
-format</dd>
-</dl>
+<ul>
+<li><code>-a</code>, <code>--attribute ATTR</code>:
+Show only one attribute</li>
+<li><code>-i</code>, <code>--id-only</code>:
+Show only the ID of matching objects</li>
+<li><code>-q</code>, <code>--query QUERY</code>
+The search query; useful to protect queries starting with -</li>
+<li><code>-R</code>, <code>--rows INT</code>:
+The number of rows to return</li>
+<li><code>-r</code>, <code>--run-list</code>:
+Show only the run list</li>
+<li><code>-o</code>, <code>--sort SORT</code>:
+The order to sort the results in</li>
+<li><code>-b</code>, <code>--start ROW</code>:
+The row to start returning results at</li>
+<li><code>-m</code>, <code>--medium</code>:
+Display medium sized output when searching nodes using the default
+summary format</li>
+<li><code>-l</code>, <code>--long</code>:
+Display long output when searching nodes using the default summary
+format</li>
+</ul>
 
 
 <h2 id="DESCRIPTION">DESCRIPTION</h2>
 
+<p>Search is a feature of the Chef Server that allows you to use a
+full-text search engine to query information about your infrastructure
+and applications. You can utilize this service via search calls in a
+recipe or the knife search command.  The search syntax is based on
+Lucene.</p>
+
+<h2 id="INDEXES">INDEXES</h2>
+
 <p>Search indexes are a feature of the Chef Server and the search
 sub-command allows querying any of the available indexes using SOLR
-query syntax. The following data types are indexed for search:
-* <em>node</em>
-* <em>role</em>
-* <em>environment</em>
-* <em>data bag</em></p>
+query syntax. The following data types are indexed for search:</p>
+
+<ul>
+<li><em>node</em></li>
+<li><em>role</em></li>
+<li><em>environment</em></li>
+<li><em>data bag</em></li>
+</ul>
+
+
+<p>Data bags are indexed by the data bag's name. For example, to search a
+data bag named "admins":</p>
+
+<pre><code>knife search admins "field:search_pattern"
+</code></pre>
+
+<h2 id="QUERY-SYNTAX">QUERY SYNTAX</h2>
+
+<p>Queries have the form <code>field:search_pattern</code> where <code>field</code> is a key in
+the JSON description of the relevant objects (nodes, roles,
+environments, or data bags).  Both <code>field</code> and <code>search_pattern</code> are
+case-sensitive.  <code>search_pattern</code> can be an exact, wildcard,
+range, or fuzzy match (see below).  The <code>field</code> supports exact
+matching and limited wildcard matching.</p>
+
+<p>Searches will return the relevant objects (nodes, roles, environments,
+or data bags) where the <code>search_pattern</code> matches the object's value of
+<code>field</code>.</p>
+
+<h3 id="FIELD-NAMES">FIELD NAMES</h3>
+
+<p>Field names are the keys within the JSON description of the object
+being searched.  Nested Keys can be searched by placing an underscore
+("_") between key names.</p>
+
+<h4 id="WILDCARD-MATCHING-FOR-FIELD-NAMES">WILDCARD MATCHING FOR FIELD NAMES</h4>
+
+<p>The field name also has limited support for wildcard matching. Both
+the "*" and "?" wildcards (see below) can be used within a field name;
+however, they cannot be the first character of the field name.</p>
+
+<h3 id="EXACT-MATCHES">EXACT MATCHES</h3>
+
+<p>Without any search modifiers, a search returns those fields for which
+the <code>search_pattern</code> exactly matches the value of <code>field</code> in the JSON
+description of the object.</p>
+
+<h3 id="WILDCARD-MATCHES">WILDCARD MATCHES</h3>
+
+<p>Search support both single- and multi-character wildcard searches
+within a search pattern.</p>
+
+<p>'?' matches exactly one character.</p>
+
+<p>'*' matches zero or more characters.</p>
+
+<h3 id="RANGE-MATCHES">RANGE MATCHES</h3>
+
+<p>Range searches allows one to match values between two given values.  To
+match values between X and Y, inclusively, use square brackets:</p>
+
+<pre><code>knife search INDEX 'field:[X TO Y]
+</code></pre>
+
+<p>To match values between X and Y, exclusively, use curly brackets:</p>
+
+<pre><code>knife search INDEX 'field:{X TO Y}'
+</code></pre>
+
+<p>Values are sorted in lexicographic order.</p>
 
-<h2 id="SYNTAX">SYNTAX</h2>
+<h3 id="FUZZY-MATCHES">FUZZY MATCHES</h3>
+
+<p>Fuzzy searches allows one to match values based on the Levenshtein
+Distance algorithm.  To perform a fuzzy match, append a tilda (~) to
+the search term:</p>
+
+<pre><code>knife search nodes 'field:term~'
+</code></pre>
+
+<p>This search would return nodes whose <code>field</code> was 'perm' or 'germ'.</p>
+
+<h3 id="BOOLEAN-OPERATORS">BOOLEAN OPERATORS</h3>
+
+<p>The boolean operators NOT, AND, and OR are supported.  To find values
+of <code>field</code> that are not X:</p>
+
+<pre><code>knife search INDEX 'field:(NOT X)'
+</code></pre>
+
+<p>To find records where <code>field1</code> is X and <code>field2</code> is Y:</p>
+
+<pre><code>knife search INDEX 'field1:X AND field2:Y'
+</code></pre>
+
+<p>To find records where <code>field</code> is X or Y:</p>
+
+<pre><code>knife search INDEX 'field:X OR field:Y'
+</code></pre>
+
+<h3 id="QUOTING-AND-SPECIAL-CHARACTERS">QUOTING AND SPECIAL CHARACTERS</h3>
+
+<p>In order to avoid having special characters and escape sequences
+within your search term interpreted by either Ruby or the shell,
+enclose them in single quotes.</p>
+
+<p>Search terms that include spaces should be enclosed in double-quotes:</p>
+
+<pre><code>knife search INDEX 'field:"term with spaces"'
+</code></pre>
+
+<p>The following characters must be escaped:</p>
+
+<pre><code>+ - &amp;&amp; || ! ( ) { } [ ] ^ " ~ * ? : \
+</code></pre>
 
 <h2 id="EXAMPLES">EXAMPLES</h2>
 
+<p>Find the nodes with the fully-qualified domain name (FQDN)
+www.example.com:</p>
+
+<pre><code>knife search nodes 'fqdn:www.example.com'
+</code></pre>
+
+<p>Find the nodes running a version of Ubuntu:</p>
+
+<pre><code>knife search nodes 'platform:ubuntu*'
+</code></pre>
+
+<p>Find all nodes running CentOS in the production environment:</p>
+
+<pre><code>knife search nodes 'chef_environment:production AND platform:centos'
+</code></pre>
+
+<h2 id="KNOWN-BUGS">KNOWN BUGS</h2>
+
+<ul>
+<li>Searches against the client index return no results in most cases. (CHEF-2477)</li>
+<li>Searches using the fuzzy match operator (~) produce an error. (CHEF-2478)</li>
+</ul>
+
+
 <h2 id="SEE-ALSO">SEE ALSO</h2>
 
 <p>   <strong>knife-ssh</strong>(1)
-   <a href="http://wiki.opscode.com/display/chef/Attributes" data-bare-link="true">http://wiki.opscode.com/display/chef/Attributes</a></p>
+   <a href="http://wiki.opscode.com/display/chef/Attributes" data-bare-link="true">http://wiki.opscode.com/display/chef/Attributes</a>
+   <a href="http://lucene.apache.org/java/2_3_2/queryparsersyntax.html">Lucene Query Parser Syntax</a></p>
 
 <h2 id="AUTHOR">AUTHOR</h2>
 
-<p>   Chef was written by Adam Jacob <a href="&#109;&#97;&#105;&#108;&#x74;&#x6f;&#x3a;&#x61;&#100;&#x61;&#109;&#64;&#x6f;&#112;&#x73;&#99;&#111;&#100;&#101;&#x2e;&#99;&#x6f;&#x6d;" data-bare-link="true">&#x61;&#100;&#x61;&#109;&#64;&#x6f;&#112;&#115;&#x63;&#111;&#100;&#101;&#x2e;&#x63;&#x6f;&#x6d;</a> with many contributions from the community.</p>
+<p>   Chef was written by Adam Jacob <a href="&#x6d;&#97;&#x69;&#x6c;&#x74;&#111;&#58;&#x61;&#x64;&#97;&#109;&#64;&#111;&#112;&#x73;&#x63;&#x6f;&#100;&#x65;&#x2e;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#x61;&#x64;&#97;&#109;&#x40;&#x6f;&#112;&#115;&#x63;&#111;&#x64;&#101;&#x2e;&#x63;&#x6f;&#x6d;</a> with many contributions from the community.</p>
 
 <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
 
-<p>   This manual page was written by Joshua Timberman <a href="&#x6d;&#x61;&#x69;&#108;&#116;&#x6f;&#x3a;&#x6a;&#x6f;&#x73;&#x68;&#117;&#97;&#64;&#x6f;&#x70;&#x73;&#99;&#x6f;&#x64;&#101;&#x2e;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#x6a;&#x6f;&#x73;&#x68;&#x75;&#97;&#64;&#111;&#x70;&#115;&#99;&#111;&#x64;&#x65;&#x2e;&#x63;&#111;&#x6d;</a>.
+<p>   This manual page was written by Joshua Timberman <a href="&#109;&#x61;&#x69;&#108;&#x74;&#x6f;&#x3a;&#x6a;&#x6f;&#x73;&#104;&#117;&#x61;&#x40;&#x6f;&#112;&#x73;&#x63;&#x6f;&#100;&#101;&#x2e;&#99;&#x6f;&#x6d;" data-bare-link="true">&#x6a;&#111;&#115;&#104;&#x75;&#x61;&#x40;&#111;&#x70;&#x73;&#x63;&#111;&#x64;&#101;&#x2e;&#99;&#111;&#x6d;</a>.
    Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
 
 <h2 id="CHEF">CHEF</h2>
@@ -133,8 +286,8 @@ query syntax. The following data types are indexed for search:
 
 
   <ol class='man-decor man-foot man foot'>
-    <li class='tl'>Chef 0.10.0</li>
-    <li class='tc'>April 2011</li>
+    <li class='tl'>Chef 0.10.4.rc.5</li>
+    <li class='tc'>August 2011</li>
     <li class='tr'>knife-search(1)</li>
   </ol>
 

data/distro/common/html/knife-ssh.1.html

@@ -90,6 +90,7 @@
 <dt><code>-m</code>, <code>--manual-list         </code></dt><dd>QUERY is a space separated list of servers</dd>
 <dt><code>-P</code>, <code>--ssh-password PASSWORD</code></dt><dd>The ssh password</dd>
 <dt><code>-x</code>, <code>--ssh-user USERNAME   </code></dt><dd>The ssh username</dd>
+<dt><code>-i</code>, <code>--identity-file IDENTITY_FILE</code></dt><dd>The SSH identity file used for authentication</dd>
 </dl>
 
 
@@ -133,11 +134,11 @@ option.</dd>
 
 <h2 id="AUTHOR">AUTHOR</h2>
 
-<p>   Chef was written by Adam Jacob <a href="&#109;&#97;&#105;&#108;&#x74;&#x6f;&#x3a;&#x61;&#100;&#x61;&#109;&#64;&#x6f;&#112;&#x73;&#99;&#111;&#100;&#101;&#x2e;&#99;&#x6f;&#x6d;" data-bare-link="true">&#x61;&#100;&#x61;&#109;&#64;&#x6f;&#112;&#115;&#x63;&#111;&#100;&#101;&#x2e;&#x63;&#x6f;&#x6d;</a> with many contributions from the community.</p>
+<p>   Chef was written by Adam Jacob <a href="&#x6d;&#97;&#x69;&#x6c;&#x74;&#x6f;&#x3a;&#97;&#x64;&#97;&#109;&#64;&#x6f;&#x70;&#x73;&#99;&#x6f;&#100;&#x65;&#x2e;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#97;&#100;&#x61;&#x6d;&#64;&#x6f;&#112;&#x73;&#99;&#111;&#100;&#101;&#x2e;&#x63;&#x6f;&#x6d;</a> with many contributions from the community.</p>
 
 <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
 
-<p>   This manual page was written by Joshua Timberman <a href="&#x6d;&#x61;&#x69;&#108;&#116;&#x6f;&#x3a;&#x6a;&#x6f;&#x73;&#x68;&#117;&#97;&#64;&#x6f;&#x70;&#x73;&#99;&#x6f;&#x64;&#101;&#x2e;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#x6a;&#x6f;&#x73;&#x68;&#x75;&#97;&#64;&#111;&#x70;&#115;&#99;&#111;&#x64;&#x65;&#x2e;&#x63;&#111;&#x6d;</a>.
+<p>   This manual page was written by Joshua Timberman <a href="&#109;&#x61;&#105;&#108;&#116;&#x6f;&#x3a;&#x6a;&#111;&#x73;&#104;&#117;&#97;&#x40;&#x6f;&#x70;&#115;&#99;&#111;&#100;&#x65;&#46;&#x63;&#111;&#x6d;" data-bare-link="true">&#x6a;&#111;&#115;&#x68;&#x75;&#97;&#x40;&#x6f;&#112;&#115;&#x63;&#x6f;&#x64;&#101;&#46;&#x63;&#111;&#109;</a>.
    Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
 
 <h2 id="CHEF">CHEF</h2>
@@ -146,8 +147,8 @@ option.</dd>
 
 
   <ol class='man-decor man-foot man foot'>
-    <li class='tl'>Chef 0.10.0</li>
-    <li class='tc'>April 2011</li>
+    <li class='tl'>Chef 0.10.4.rc.5</li>
+    <li class='tc'>August 2011</li>
     <li class='tr'>knife-ssh(1)</li>
   </ol>
 

data/distro/common/html/knife-status.1.html

@@ -105,11 +105,11 @@ may not be publicly reachable.</p>
 
 <h2 id="AUTHOR">AUTHOR</h2>
 
-<p>   Chef was written by Adam Jacob <a href="&#109;&#x61;&#x69;&#x6c;&#116;&#111;&#x3a;&#97;&#x64;&#x61;&#x6d;&#x40;&#x6f;&#112;&#115;&#99;&#x6f;&#100;&#x65;&#46;&#99;&#x6f;&#x6d;" data-bare-link="true">&#97;&#x64;&#97;&#x6d;&#64;&#111;&#112;&#115;&#99;&#x6f;&#100;&#101;&#46;&#99;&#x6f;&#109;</a> with many contributions from the community.</p>
+<p>   Chef was written by Adam Jacob <a href="&#x6d;&#97;&#105;&#x6c;&#116;&#111;&#58;&#97;&#100;&#x61;&#109;&#64;&#111;&#x70;&#x73;&#99;&#x6f;&#100;&#101;&#46;&#x63;&#x6f;&#109;" data-bare-link="true">&#97;&#100;&#x61;&#109;&#x40;&#x6f;&#x70;&#115;&#x63;&#x6f;&#100;&#101;&#46;&#99;&#111;&#109;</a> with many contributions from the community.</p>
 
 <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
 
-<p>   This manual page was written by Joshua Timberman <a href="&#x6d;&#97;&#105;&#108;&#x74;&#111;&#x3a;&#106;&#x6f;&#x73;&#x68;&#117;&#x61;&#64;&#x6f;&#112;&#115;&#x63;&#x6f;&#100;&#101;&#x2e;&#x63;&#111;&#109;" data-bare-link="true">&#x6a;&#111;&#115;&#x68;&#x75;&#x61;&#64;&#x6f;&#x70;&#x73;&#x63;&#x6f;&#100;&#x65;&#x2e;&#x63;&#111;&#x6d;</a>.
+<p>   This manual page was written by Joshua Timberman <a href="&#109;&#x61;&#105;&#108;&#x74;&#111;&#58;&#106;&#x6f;&#115;&#104;&#117;&#x61;&#x40;&#111;&#x70;&#115;&#99;&#x6f;&#x64;&#x65;&#46;&#x63;&#111;&#109;" data-bare-link="true">&#x6a;&#111;&#115;&#x68;&#117;&#97;&#x40;&#x6f;&#x70;&#115;&#x63;&#x6f;&#100;&#x65;&#46;&#99;&#x6f;&#109;</a>.
    Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
 
 <h2 id="CHEF">CHEF</h2>
@@ -118,8 +118,8 @@ may not be publicly reachable.</p>
 
 
   <ol class='man-decor man-foot man foot'>
-    <li class='tl'>Chef 0.10.0</li>
-    <li class='tc'>April 2011</li>
+    <li class='tl'>Chef 0.10.4.rc.5</li>
+    <li class='tc'>August 2011</li>
     <li class='tr'>knife-status(1)</li>
   </ol>
 

data/distro/common/html/knife-tag.1.html

@@ -114,11 +114,11 @@
 
 <h2 id="AUTHOR">AUTHOR</h2>
 
-<p>   Chef was written by Adam Jacob <a href="&#109;&#x61;&#105;&#x6c;&#x74;&#x6f;&#58;&#x61;&#100;&#x61;&#x6d;&#x40;&#111;&#x70;&#115;&#99;&#111;&#x64;&#x65;&#x2e;&#x63;&#x6f;&#109;" data-bare-link="true">&#x61;&#100;&#97;&#109;&#64;&#111;&#x70;&#115;&#99;&#111;&#x64;&#x65;&#x2e;&#99;&#x6f;&#x6d;</a> with many contributions from the community.</p>
+<p>   Chef was written by Adam Jacob <a href="&#x6d;&#x61;&#x69;&#x6c;&#x74;&#x6f;&#x3a;&#x61;&#x64;&#97;&#x6d;&#x40;&#x6f;&#112;&#115;&#99;&#x6f;&#100;&#x65;&#x2e;&#x63;&#x6f;&#109;" data-bare-link="true">&#x61;&#x64;&#97;&#x6d;&#x40;&#x6f;&#112;&#x73;&#99;&#x6f;&#100;&#x65;&#x2e;&#x63;&#111;&#109;</a> with many contributions from the community.</p>
 
 <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
 
-<p>   This manual page was written by Daniel DeLeo <a href="&#109;&#97;&#105;&#108;&#116;&#x6f;&#58;&#x64;&#x61;&#110;&#64;&#111;&#x70;&#x73;&#99;&#x6f;&#100;&#101;&#x2e;&#99;&#111;&#x6d;" data-bare-link="true">&#x64;&#x61;&#x6e;&#64;&#111;&#x70;&#115;&#99;&#111;&#x64;&#101;&#46;&#x63;&#x6f;&#x6d;</a>.
+<p>   This manual page was written by Daniel DeLeo <a href="&#109;&#x61;&#x69;&#108;&#116;&#111;&#58;&#100;&#x61;&#110;&#64;&#x6f;&#x70;&#x73;&#x63;&#x6f;&#100;&#x65;&#46;&#x63;&#111;&#109;" data-bare-link="true">&#100;&#97;&#110;&#64;&#x6f;&#x70;&#x73;&#x63;&#x6f;&#100;&#101;&#x2e;&#99;&#x6f;&#x6d;</a>.
    Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
 
 <h2 id="CHEF">CHEF</h2>
@@ -127,8 +127,8 @@
 
 
   <ol class='man-decor man-foot man foot'>
-    <li class='tl'>Chef 0.10.0</li>
-    <li class='tc'>April 2011</li>
+    <li class='tl'>Chef 0.10.4.rc.5</li>
+    <li class='tc'>August 2011</li>
     <li class='tr'>knife-tag(1)</li>
   </ol>
 

data/distro/common/html/knife.1.html

@@ -266,12 +266,12 @@ data editing entirely.</dd>
 
 <h2 id="AUTHOR">AUTHOR</h2>
 
-<p>   Chef was written by Adam Jacob <a href="&#109;&#x61;&#105;&#x6c;&#x74;&#x6f;&#58;&#x61;&#100;&#x61;&#x6d;&#x40;&#111;&#x70;&#115;&#99;&#111;&#x64;&#x65;&#x2e;&#x63;&#x6f;&#109;" data-bare-link="true">&#x61;&#100;&#97;&#109;&#64;&#111;&#x70;&#115;&#99;&#111;&#x64;&#x65;&#x2e;&#99;&#x6f;&#x6d;</a> of Opscode
+<p>   Chef was written by Adam Jacob <a href="&#x6d;&#97;&#105;&#x6c;&#116;&#111;&#58;&#97;&#100;&#x61;&#109;&#64;&#111;&#x70;&#x73;&#99;&#x6f;&#100;&#101;&#46;&#x63;&#x6f;&#109;" data-bare-link="true">&#97;&#100;&#x61;&#109;&#x40;&#x6f;&#x70;&#115;&#x63;&#x6f;&#100;&#101;&#46;&#99;&#111;&#109;</a> of Opscode
    (<a href="http://www.opscode.com" data-bare-link="true">http://www.opscode.com</a>), with contributions from the community.</p>
 
 <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
 
-<p>   This manual page was written by Joshua Timberman <a href="&#109;&#97;&#105;&#108;&#116;&#x6f;&#58;&#x6a;&#x6f;&#115;&#104;&#117;&#x61;&#x40;&#111;&#x70;&#115;&#99;&#x6f;&#100;&#101;&#x2e;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#106;&#111;&#x73;&#104;&#117;&#97;&#x40;&#111;&#112;&#x73;&#x63;&#x6f;&#x64;&#101;&#46;&#x63;&#111;&#109;</a>.</p>
+<p>   This manual page was written by Joshua Timberman <a href="&#109;&#x61;&#105;&#108;&#x74;&#111;&#58;&#106;&#x6f;&#115;&#104;&#117;&#x61;&#x40;&#111;&#x70;&#115;&#99;&#x6f;&#x64;&#x65;&#46;&#x63;&#111;&#109;" data-bare-link="true">&#x6a;&#111;&#115;&#x68;&#117;&#97;&#x40;&#x6f;&#x70;&#115;&#x63;&#x6f;&#100;&#x65;&#46;&#99;&#x6f;&#109;</a>.</p>
 
 <h2 id="LICENSE">LICENSE</h2>
 
@@ -285,8 +285,8 @@ data editing entirely.</dd>
 
 
   <ol class='man-decor man-foot man foot'>
-    <li class='tl'>Chef 0.10.0</li>
-    <li class='tc'>April 2011</li>
+    <li class='tl'>Chef 0.10.4.rc.5</li>
+    <li class='tc'>August 2011</li>
     <li class='tr'>knife(1)</li>
   </ol>
 

data/distro/common/html/shef.1.html

@@ -258,12 +258,12 @@ and may become out of sync with the behavior of those libraries.</p>
 
 <h2 id="AUTHOR">AUTHOR</h2>
 
-<p>   Chef was written by Adam Jacob <a href="&#109;&#97;&#105;&#108;&#116;&#x6f;&#x3a;&#x61;&#100;&#97;&#x6d;&#x40;&#111;&#x70;&#x73;&#99;&#x6f;&#x64;&#101;&#x2e;&#x63;&#111;&#109;" data-bare-link="true">&#x61;&#x64;&#97;&#109;&#64;&#x6f;&#112;&#x73;&#x63;&#111;&#x64;&#x65;&#46;&#99;&#111;&#x6d;</a> with many
+<p>   Chef was written by Adam Jacob <a href="&#x6d;&#97;&#x69;&#108;&#116;&#111;&#58;&#97;&#x64;&#97;&#109;&#64;&#x6f;&#x70;&#x73;&#99;&#111;&#100;&#x65;&#x2e;&#99;&#111;&#x6d;" data-bare-link="true">&#97;&#100;&#97;&#109;&#x40;&#x6f;&#x70;&#115;&#x63;&#x6f;&#x64;&#x65;&#46;&#99;&#x6f;&#109;</a> with many
    contributions from the community. Shef was written by Daniel DeLeo.</p>
 
 <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
 
-<p>   This manual page was written by Daniel DeLeo <a href="&#x6d;&#97;&#x69;&#108;&#116;&#111;&#x3a;&#100;&#x61;&#110;&#x40;&#111;&#112;&#x73;&#x63;&#x6f;&#100;&#x65;&#x2e;&#99;&#111;&#x6d;" data-bare-link="true">&#100;&#x61;&#110;&#x40;&#111;&#112;&#115;&#99;&#111;&#x64;&#101;&#x2e;&#x63;&#x6f;&#x6d;</a>.
+<p>   This manual page was written by Daniel DeLeo <a href="&#x6d;&#97;&#105;&#x6c;&#x74;&#x6f;&#x3a;&#100;&#x61;&#x6e;&#x40;&#x6f;&#x70;&#x73;&#99;&#x6f;&#x64;&#101;&#46;&#99;&#111;&#x6d;" data-bare-link="true">&#100;&#x61;&#x6e;&#64;&#111;&#x70;&#115;&#x63;&#x6f;&#x64;&#x65;&#x2e;&#99;&#x6f;&#x6d;</a>.
    Permission is granted to copy, distribute and / or modify this
    document under the terms of the Apache 2.0 License.</p>
 
@@ -273,8 +273,8 @@ and may become out of sync with the behavior of those libraries.</p>
 
 
   <ol class='man-decor man-foot man foot'>
-    <li class='tl'>Chef 0.10.0</li>
-    <li class='tc'>April 2011</li>
+    <li class='tl'>Chef 0.10.4.rc.5</li>
+    <li class='tc'>August 2011</li>
     <li class='tr'>shef(1)</li>
   </ol>
 

data/distro/common/man/man1/knife-bootstrap.1

@@ -0,0 +1,189 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "KNIFE\-BOOTRAP" "1" "August 2011" "Chef 0.10.4.rc.5" "Chef Manual"
+.
+.SH "NAME"
+\fBknife\-bootrap\fR \- Install Chef Client on a remote host
+.
+.SH "SYNOPSIS"
+\fBknife\fR \fBbootstrap\fR \fI(options)\fR
+.
+.TP
+\fB\-i\fR, \fB\-\-identity\-file IDENTITY_FILE\fR
+The SSH identity file used for authentication
+.
+.TP
+\fB\-N\fR, \fB\-\-node\-name NAME\fR
+The Chef node name for your new node
+.
+.TP
+\fB\-P\fR, \fB\-\-ssh\-password PASSWORD\fR
+The ssh password
+.
+.TP
+\fB\-x\fR, \fB\-\-ssh\-user USERNAME\fR
+The ssh username
+.
+.TP
+\fB\-\-prerelease\fR
+Install pre\-release Chef gems
+.
+.TP
+\fB\-r\fR, \fB\-\-run\-list RUN_LIST\fR
+Comma separated list of roles/recipes to apply
+.
+.TP
+\fB\-P\fR, \fB\-\-ssh\-password PASSWORD\fR
+The ssh password
+.
+.TP
+\fB\-x\fR, \fB\-\-ssh\-user USERNAME\fR
+The ssh username
+.
+.TP
+\fB\-\-template\-file TEMPLATE\fR
+Full path to location of template to use
+.
+.TP
+\fB\-\-sudo\fR
+Execute the bootstrap via sudo
+.
+.TP
+\fB\-d\fR, \fB\-\-distro DISTRO\fR
+Bootstrap a distro using a template
+.
+.SH "DESCRIPTION"
+Performs a Chef Bootstrap on the target node\. The goal of the bootstrap is to get Chef installed on the target system so it can run Chef Client with a Chef Server\. The main assumption is a baseline OS installation exists\. This sub\-command is used internally by some cloud computing plugins\.
+.
+.P
+The bootstrap sub\-command supports supplying a template to perform the bootstrap steps\. If the distro is not specified (via \fB\-d\fR or \fB\-\-distro\fR option), an Ubuntu 10\.04 host bootstrapped with RubyGems is assumed\. The \fBDISTRO\fR value corresponds to the base filename of the template, in other words \fBDISTRO\fR\.erb\. A template file can be specified with the \fB\-\-template\-file\fR option in which case the \fBDISTRO\fR is not used\. The sub\-command looks in the following locations for the template to use:
+.
+.IP "\(bu" 4
+\fBbootstrap\fR directory in the installed Chef Knife library\.
+.
+.IP "\(bu" 4
+\fBbootstrap\fR directory in the \fB$PWD/\.chef\fR\.
+.
+.IP "\(bu" 4
+\fBbootstrap\fR directory in the users \fB$HOME/\.chef\fR\.
+.
+.IP "" 0
+.
+.P
+The default bootstrap templates are scripts that get copied to the target node (FQDN)\. The following distros are supported:
+.
+.IP "\(bu" 4
+centos5\-gems
+.
+.IP "\(bu" 4
+fedora13\-gems
+.
+.IP "\(bu" 4
+ubuntu10\.04\-gems
+.
+.IP "\(bu" 4
+ubuntu10\.04\-apt
+.
+.IP "" 0
+.
+.P
+The gems installations will use RubyGems 1\.3\.6 and Chef installed as a gem\. The apt installation will use the Opscode APT repository\. The RubyGems installation requires installing gems with native extensions, so development related packages (ruby\-dev, build\-essential) are installed\. These are not installed with the apt installation, as native extensions are already compiled in the required packages\.
+.
+.P
+In addition to handling the software installation, these bootstrap templates do the following:
+.
+.IP "\(bu" 4
+Write the validation\.pem per the local knife configuration\.
+.
+.IP "\(bu" 4
+Write a default config file for Chef (\fB/etc/chef/client\.rb\fR) using values from the \fBknife\.rb\fR\.
+.
+.IP "\(bu" 4
+Create a JSON attributes file containing the specified run list and run Chef\.
+.
+.IP "" 0
+.
+.P
+In the case of the RubyGems, the \fBclient\.rb\fR will be written from scratch with a minimal set of values; see \fBEXAMPLES\fR\. In the case of APT Package installation, \fBclient\.rb\fR will have the \fBvalidation_client_name\fR appended if it is not set to \fBchef\-validator\fR (default config value), and the \fBnode_name\fR will be added if \fBchef_node_name\fR option is specified\.
+.
+.P
+When this is complete, the bootstrapped node will have:
+.
+.IP "\(bu" 4
+Latest Chef version installed from RubyGems or APT Packages from Opscode\. This may be a later version than the local system\.
+.
+.IP "\(bu" 4
+Be validated with the configured Chef Server\.
+.
+.IP "\(bu" 4
+Have run Chef with its default run list if one is specfied\.
+.
+.IP "" 0
+.
+.P
+Additional custom bootstrap templates can be created and stored in \fB\.chef/bootstrap/DISTRO\.erb\fR, replacing \fBDISTRO\fR with the value passed with the \fB\-d\fR or \fB\-\-distro\fR option\. See \fBEXAMPLES\fR for more information\.
+.
+.SH "EXAMPLES"
+Setting up a custom bootstrap is fairly straightforward\. Create a \fB\.chef/bootstrap\fR directory in your Chef Repository or in \fB$HOME/\.chef/bootstrap\fR\. Then create the ERB template file\.
+.
+.IP "" 4
+.
+.nf
+
+mkdir ~/\.chef/bootstrap
+vi ~/\.chef/bootstrap/debian5\.0\-apt\.erb
+.
+.fi
+.
+.IP "" 0
+.
+.P
+For example, to create a new bootstrap template that should be used when setting up a new Debian node\. Edit the template to run the commands, set up the validation certificate and the client configuration file, and finally to run chef\-client on completion\. The bootstrap template can be called with:
+.
+.IP "" 4
+.
+.nf
+
+knife bootstrap mynode\.example\.com \-\-template\-file ~/\.chef/bootstrap/debian5\.0\-apt\.erb
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Or,
+.
+.IP "" 4
+.
+.nf
+
+knife bootstrap mynode\.example\.com \-\-distro debian5\.0\-apt
+.
+.fi
+.
+.IP "" 0
+.
+.P
+The \fB\-\-distro\fR parameter will automatically look in the \fB~/\.chef/bootstrap\fR directory for a file named \fBdebian5\.0\-apt\.erb\fR\.
+.
+.P
+Templates provided by the Chef installation are located in \fBBASEDIR/lib/chef/knife/bootstrap/*\.erb\fR, where \fIBASEDIR\fR is the location where the package or Gem installed the Chef client libraries\.
+.
+.SH "BUGS"
+\fBknife bootstrap\fR is not capable of bootstrapping multiple hosts in parallel\.
+.
+.P
+The bootstrap script is passed as an argument to sh(1) on the remote system, so sensitive information contained in the script will be visible to other users via the process list using tools such as ps(1)\.
+.
+.SH "SEE ALSO"
+\fBknife\-ssh\fR(1)
+.
+.SH "AUTHOR"
+Chef was written by Adam Jacob \fIadam@opscode\.com\fR with many contributions from the community\.
+.
+.SH "DOCUMENTATION"
+This manual page was written by Joshua Timberman \fIjoshua@opscode\.com\fR\. Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2\.0 License\.
+.
+.SH "CHEF"
+Knife is distributed with Chef\. \fIhttp://wiki\.opscode\.com/display/chef/Home\fR