truesearch.query ================ Search the TrueSearch index for files and directories in ``path`` and its subdirectories. TrueSearch uses the index that answers macOS Spotlight searches through SMB. Middleware converts the filters into a Spotlight query. Thus, a query gets the same results as a Spotlight search from a Mac. .. raw:: html
The directory to search, the filters, the options, and the user.
No Additional PropertiesThe directory to search. Use an absolute path in a dataset that TrueSearch indexes. TrueSearch indexes each dataset that contains an SMB share with Spotlight search enabled, or a WebShare share with search enabled. If path is above the indexed directory of the dataset, TrueSearch searches all of the indexed directory.
Must be at least 1 characters long
The user to search as. The user must be able to access path. The results include only the files and directories that this user can access. An administrator can use this to see what the user can find. If username is null, the search runs as root and returns all matches.
Also search the indexed datasets that are mounted beneath path. Each dataset has a separate index. Without recursive, the query searches only the dataset that contains path. With recursive, the query merges the results of all datasets, newest first. limit applies to the merged results.
Filters can also use macos_kind, tags, and comment. These fields are not in the results.
[
[
"name",
"=",
"bob"
]
]
[
[
"OR",
[
[
"name",
"=",
"bob"
],
[
"name",
"=",
"larry"
]
]
]
]
Options for the results of the query.
No Additional PropertiesThe maximum number of entries to return.
Value must be greater or equal to 1 and lesser or equal to 1000
The entries that match, with the newest entries first.
No Additional ItemsThe absolute path of the file or directory.
The name of the file or directory.
The type of the file or directory. OTHER is a FIFO, a socket, or a device file.
The size in bytes.
The file mode, as st_mode gives it.
The user ID of the owner.
The group ID of the owner group.
The last time that the data changed.
The time that the file was created.
The last time that the file was read.
The inode number, as st_ino gives it.
A file handle, encoded in base64. Use it on the NAS to open the file in a race-free manner. It identifies the file uniquely in its dataset for the lifetime of the file.