mdfind - Run Spotlight searches against an SMB server
mvxattr {server} {sharename} {query} [-p, --path] [-L, --live]
MDFIND(1) User Commands MDFIND(1)
NAME
mdfind - Run Spotlight searches against an SMB server
SYNOPSIS
mvxattr {server} {sharename} {query} [-p, --path] [-L, --live]
DESCRIPTION
This tool is part of the samba(1) suite.
mdfind is a simple utility to run Spotlight searches against an SMB
server that runs the Spotlight mdssvc RPC service.
OPTIONS
server
The SMB server name or IP address to connect to.
sharename
The name of a share on the server.
query
The query expression syntax is a simplified form of filename
globbing familiar to shell users. Queries have the following
format:
attribute=="value"
For queries against a Samba server with Spotlight enabled using the
Elasticsearch backend, the list of supported metadata attributes is
given by the JSON attribute mapping file, typically installed at
/usr/share/samba/mdssvc/elasticsearch_mappings.json
-p PATH, --path=PATH
Server side path to search, defaults to "/"
-L, --live
Query remains running.
EXAMPLES
Search all indexed metadata attributes, exact match:
'*=="Samba"'
Search all indexed metadata attributes, prefix match:
'*=="Samba*"'
Search by filename:
'kMDItemFSName=="Samba*"'
Search by date:
'kMDItemFSContentChangeDate<$time.iso(2018-10-01T10:00:00Z)'
Search files's content:
'kMDItemTextContent=="Samba*"'
Expressions:
kMDItemFSName=="Samba*"||kMDItemTextContent=="Tango*"'
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | service/network/samba |
+---------------+-----------------------+
|Stability | Volatile |
+---------------+-----------------------+
SEE ALSO
File Metadata Search Programming Guide
https://developer.apple.com/library/archive/documentation/Carbon/Conceptual/SpotlightQuery/Concepts/Introduction.html
VERSION
This man page is part of version 4.13.17 of the Samba suite.
AUTHOR
The original Samba software and related utilities were created by
Andrew Tridgell. Samba is now developed by the Samba Team as an Open
Source project similar to the way the Linux kernel is developed.
The mdfind manpage was written by Ralph Boehme.
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
https://download.samba.org/pub/samba/stable/samba-4.13.17.tar.gz.
Further information about this software can be found on the open source
community website at http://www.samba.org/.
Samba 4.13.17 06/28/2022 MDFIND(1)