function is on target
- is_on_target <item> <varname> [<path>[:<path2>...]]
The optional 3rd argument specifies a list of places to search for the item. It is a colon-separated list of directory names. If this argument is not specified, then the 'find' command is used on the target to try to locate the item, by name, from the root of the filesystem.
Note that if the target filesystem is large, this operation could take a long time.
- $1 is the item to find in the remote filesystem
- $2 is the name of the variable to set
- $3 (optional) is a colon-separated path of directories to scan for this item in