Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

mdfind (1)

Name

mdfind - Run Spotlight searches against an SMB server

Synopsis

mvxattr {server} {sharename} {query} [-p, --path] [-L, --live]

Description

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)