mdfind(1)

1MDFIND(1)                        User Commands                       MDFIND(1)
2
3
4

NAME

6       mdfind - Run Spotlight searches against an SMB server
7

SYNOPSIS

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

DESCRIPTION

12       This tool is part of the samba(1) suite.
13
14       mdfind is a simple utility to run Spotlight searches against an SMB
15       server that runs the Spotlight mdssvc RPC service.
16

OPTIONS

18       server
19           The SMB server name or IP address to connect to.
20
21       sharename
22           The name of a share on the server.
23
24       query
25           The query expression syntax is a simplified form of filename
26           globbing familiar to shell users. Queries have the following
27           format:
28
29           attribute=="value"
30
31           For queries against a Samba server with Spotlight enabled using the
32           Elasticsearch backend, the list of supported metadata attributes is
33           given by the JSON attribute mapping file, typically installed at
34           /usr/share/samba/mdssvc/elasticsearch_mappings.json
35
36       -p PATH, --path=PATH
37           Server side path to search, defaults to "/"
38
39       -L, --live
40           Query remains running.
41

EXAMPLES

43       Search all indexed metadata attributes, exact match:
44
45                 '*=="Samba"'
46
47
48       Search all indexed metadata attributes, prefix match:
49
50                 '*=="Samba*"'
51
52
53       Search by filename:
54
55                 'kMDItemFSName=="Samba*"'
56
57
58       Search by date:
59
60                 'kMDItemFSContentChangeDate<$time.iso(2018-10-01T10:00:00Z)'
61
62
63       Search files's content:
64
65                 'kMDItemTextContent=="Samba*"'
66
67
68       Expressions:
69
70                 kMDItemFSName=="Samba*"||kMDItemTextContent=="Tango*"'
71
72

VERSION

78       This man page is part of version 4.14.5 of the Samba suite.
79

AUTHOR

81       The original Samba software and related utilities were created by
82       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
83       Source project similar to the way the Linux kernel is developed.
84
85       The mdfind manpage was written by Ralph Boehme.
86
87
88
89Samba 4.14.5                      06/01/2021                         MDFIND(1)