Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mdfind(1) [osx man page]

mdfind(1)						    BSD General Commands Manual 						 mdfind(1)

NAME
mdfind -- finds files matching a given query SYNOPSIS
mdfind [-live] [-count] [-onlyin directory] [-name fileName] query DESCRIPTION
The mdfind command consults the central metadata store and returns a list of files that match the given metadata query. The query can be a string or a query expression. The following options are available: -0 Prints an ASCII NUL character after each result path. This is useful when used in conjunction with xargs -0. -live Causes the mdfind command to provide live-updates to the number of files matching the query. When an update causes the query results to change the number of matches is updated. The find can be cancelled by typing ctrl-C. -count Causes the mdfind command to output the total number of matches, instead of the path to the matching items. -onlyin dir Limit the scope of the search to the directory specified. -name fileName Searches for matching file names only. -literal Force the provided query string to be taken as a literal query string, without interpretation. -interpret Force the provided query string to be interpreted as if the user had typed the string into the Spotlight menu. For example, the string "search" would produce the following query string: (* = search* cdw || kMDItemTextContent = search* cdw) EXAMPLES
The following examples are shown as given to the shell. This returns all files with any metadata attribute value matching the string "image": mdfind image This returns all files that contain "MyFavoriteAuthor" in the kMDItemAuthor metadata attribute: mdfind "kMDItemAuthor == '*MyFavoriteAuthor*'" This returns all files with any metadata attribute value matching the string "skateboard". The find continues to run after gathering the initial results, providing a count of the number of files that match the query. mdfind -live skateboard To get a list of the available attributes for use in constructing queries, see mdimport(1), particularly the -X switch. SEE ALSO
mdimport(1), mdls(1), mdutil(1), xargs(1) Mac OS X June 10, 2004 Mac OS X

Check Out this Related Man Page

YAZ_SEARCH(3)								 1							     YAZ_SEARCH(3)

yaz_search - Prepares for a search

SYNOPSIS
bool yaz_search (resource $id, string $type, string $query) DESCRIPTION
yaz_search(3) prepares for a search on the given connection. Like yaz_connect(3) this function is non-blocking and only prepares for a search to be executed later when yaz_wait(3) is called. PARAMETERS
o $id - The connection resource returned by yaz_connect(3). o $type - This parameter represents the query type - only "rpn" is supported now in which case the third argument specifies a Type-1 query in prefix query notation. o $query - The RPN query is a textual representation of the Type-1 query as defined by the Z39.50 standard. However, in the text represen- tation as used by YAZ a prefix notation is used, that is the operator precedes the operands. The query string is a sequence of tokens where white space is ignored unless surrounded by double quotes. Tokens beginning with an at-character ( @) are considered operators, otherwise they are treated as search terms. RPN Operators +-----------------------------+---------------------------------------------------+ | Construct | | | | | | | Description | | | | +-----------------------------+---------------------------------------------------+ | | | | @and query1 query2 | | | | | | | intersection of query1 and query2 | | | | | | | | @or query1 query2 | | | | | | | union of query1 and query2 | | | | | | | | @not query1 query2 | | | | | | | query1 and not query2 | | | | | | | | @set name | | | | | | | result set reference | | | | | | | | @attrset set query | | | | | | | specifies attribute-set for query. This con- | | | struction is only allowed once - in the beginning | | | of the whole query | | | | | | | |@attr [set] type=value query | | | | | | | applies attribute to query. The type and value | | | are integers specifying the attribute-type and | | | attribute-value respectively. The set, if given, | | | specifies the attribute-set. | | | | +-----------------------------+---------------------------------------------------+ You can find information about attributes at the Z39.50 Maintenance Agency site. Note If you would like to use a more friendly notation, use the CCL parser - functions yaz_ccl_conf(3) and yaz_ccl_parse(3). RETURN VALUES
Returns TRUE on success or FALSE on failure. EXAMPLES
Example #1 Query Examples You can search for simple terms, like this: computer The query "knuth donald" This query applies two attributes for the same phrase. The query @and @or a b @not @or c d e (a or b) and ((c or d) not e). Another, more complex, one: @attrset gils @and @attr 1=4 art @attr 1=2000 company art occur in the title (GILS,BIB-1) and in which company occur as Distributor (GILS). PHP Documentation Group YAZ_SEARCH(3)
Man Page