NAME [edit section]

= NAME =
is_on_sdk

SYNOPSIS [edit section]

= SYNOPSIS =
 * is_on_sdk <item> <varname> [<path>[:<path2>...]]

The function is_on_sdk scans for the given filesystem item (file or directory) in the SDK (Software Development Kit), or toolchain, and if found puts the absolute path of the item into the indicated variable.

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.

EXAMPLES [edit section]

= EXAMPLES =
Here are some sample invocations:
{{{#!YellowBox
    is_on_sdk libtiff.so LIBTIFF /lib:/usr/lib/:/usr/local/lib:/usr/lib/$ARCH-linux-*/
    assert_define LIBTIFF "SDK is missing libtiff.so - cannot build test"
}}}

ENVIRONMENT and ARGUMENTS [edit section]

= ENVIRONMENT and ARGUMENTS =
 * $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, inside the SDK directory.

RETURN [edit section]

= RETURN =
Returns non-zero on error.  If the item is found, the full path to
the item is returned as the value of the specified variable.

SOURCE [edit section]

= SOURCE =
Located in ''scripts/functions.sh''

SEE ALSO [edit section]

= SEE ALSO =
 * [[function_test_pre_check|test_pre_check]], [[function_is_on_target|is_on_target]], [[function_is_on_target_path|is_on_target_path]]