diff options
| author | jamescott <jamescott@opscode.com> | 2013-10-16 15:16:54 -0700 |
|---|---|---|
| committer | jamescott <jamescott@opscode.com> | 2013-10-16 15:16:58 -0700 |
| commit | 0817fb8ee4151808c40c1acb7432350aa75bad13 (patch) | |
| tree | d7242d777aa517b9595f2db4fe4dc5adb09f9689 /distro/common | |
| parent | c3281e467810cdc65ff1388df70b22cba62f5199 (diff) | |
| download | chef-0817fb8ee4151808c40c1acb7432350aa75bad13.tar.gz | |
update descriptions for search
Diffstat (limited to 'distro/common')
| -rw-r--r-- | distro/common/man/man1/knife-search.1 | 51 |
1 files changed, 50 insertions, 1 deletions
diff --git a/distro/common/man/man1/knife-search.1 b/distro/common/man/man1/knife-search.1 index 2344bc3992..6f4edebe1f 100644 --- a/distro/common/man/man1/knife-search.1 +++ b/distro/common/man/man1/knife-search.1 @@ -107,6 +107,55 @@ $ knife search INDEX SEARCH_QUERY .sp where \fBINDEX\fP is one of \fBclient\fP, \fBenvironment\fP, \fBnode\fP, \fBrole\fP, or the name of a data bag and \fBSEARCH_QUERY\fP is the search query syntax for the query that will be executed. .sp +\fBINDEX\fP is implied if omitted, and will default to \fBnode\fP. For example: +.sp +.nf +.ft C +$ knife search \(aq*:*\(aq \-i +.ft P +.fi +.sp +will return something similar to: +.sp +.nf +.ft C +8 items found + +centos\-62\-dev +opensuse\-1203 +ubuntu\-1304\-dev +ubuntu\-1304\-orgtest +ubuntu\-1204\-ohai\-test +ubuntu\-1304\-ifcfg\-test +ohai\-test +win2k8\-dev +.ft P +.fi +.sp +and is the same search as: +.sp +.nf +.ft C +$ knife node search \(aq*:*" \-i +.ft P +.fi +.sp +If the \fBSEARCH_QUERY\fP does not contain a colon character (\fB:\fP), then the default query pattern is \fBtags:*#{@query}* OR roles:*#{@query}* OR fqdn:*#{@query}* OR addresses:*#{@query}*\fP, which means the following two search queries are effectively the same: +.sp +.nf +.ft C +$ knife search ubuntu +.ft P +.fi +.sp +or: +.sp +.nf +.ft C +$ knife search node "tags:*ubuntu* OR roles:*ubuntu* OR fqdn:*ubuntu* (etc.)" +.ft P +.fi +.sp \fBOptions\fP .sp This sub\-command has the following options: @@ -122,7 +171,7 @@ The row at which return results will begin. Indicates that only matching object IDs will be shown. .TP .B \fBINDEX\fP -The name of the index to be queried: \fBclient\fP, \fBenvironment\fP, \fBnode\fP, \fBrole\fP, or \fBDATA_BAG_NAME\fP. +The name of the index to be queried: \fBclient\fP, \fBenvironment\fP, \fBnode\fP, \fBrole\fP, or \fBDATA_BAG_NAME\fP. Default index: \fBnode\fP. .TP .B \fB\-l\fP, \fB\-\-long\fP Display long output when searching nodes while using the default summary format. |