[ADC-Ext 1.0.8] Advanced search (ASCH)
Posted: 25 Jun 2013, 15:57
This extension is mainly meant for allowing searches in partial lists. Supporting clients should advertise the "ASCH" support in their INF (that is sent to the hub).
New SCH parameters:
Matching options (only applies to search terms, not excluded words):
MT0: Match full path (partial match)
MT1: Match file/directory name only (partial match)
MT2: Match file/directory name only (exact match)
PP1 - The responder should send the parent path of the matching item. For files the result should be for the containing files and for directories the result is for the parent directory. The responder should
check that only one result is sent for each directory. This is useful when searching in a partial list, so the requester can then download the partial list from a correct path and locate the matching items
in the directory by itself (less search results to send).
OT - Older than. Newest possible (absolute) time for a responded item. Unix time.
NT - Newer than. The oldest possible (absolute) time for a responded item. Unix time.
MR - Maximum number of wanted results (can only be used for D type searches?). The responder may also choose to send less results if the requested count isn't reasonable.
PA - Path in the share where to search from (relative to the unnamed root). This can only be used for D type searches.
RE1 - Require a reply. This can only be used for D type searches.
The reply is a DSTA message that contains the following extra parameters:
FC - This should be DSCH (added also for error messages)
TO - Token of the search
RC - Number of results sent
If no results were found, the reply should still be sent with the success code (with "RC0")
New RES parameters:
FI - Number of files in a directory (recursive, directory search results only)
FO - Number of folders in a directory (recursive, directory search results only)
DA - Modify date of a file/folder (depending on the result type). Unix time.
New SCH parameters:
Matching options (only applies to search terms, not excluded words):
MT0: Match full path (partial match)
MT1: Match file/directory name only (partial match)
MT2: Match file/directory name only (exact match)
PP1 - The responder should send the parent path of the matching item. For files the result should be for the containing files and for directories the result is for the parent directory. The responder should
check that only one result is sent for each directory. This is useful when searching in a partial list, so the requester can then download the partial list from a correct path and locate the matching items
in the directory by itself (less search results to send).
OT - Older than. Newest possible (absolute) time for a responded item. Unix time.
NT - Newer than. The oldest possible (absolute) time for a responded item. Unix time.
MR - Maximum number of wanted results (can only be used for D type searches?). The responder may also choose to send less results if the requested count isn't reasonable.
PA - Path in the share where to search from (relative to the unnamed root). This can only be used for D type searches.
RE1 - Require a reply. This can only be used for D type searches.
The reply is a DSTA message that contains the following extra parameters:
FC - This should be DSCH (added also for error messages)
TO - Token of the search
RC - Number of results sent
If no results were found, the reply should still be sent with the success code (with "RC0")
New RES parameters:
FI - Number of files in a directory (recursive, directory search results only)
FO - Number of folders in a directory (recursive, directory search results only)
DA - Modify date of a file/folder (depending on the result type). Unix time.