Skip to Content

Default language.

Information
Important This documentation space contains information about the on-premises version of BMC Helix Discovery. If you are using the SaaS version of BMC Helix Discovery, see BMC Helix Discovery (SaaS).

discovery.fileInfo

discovery.fileInfo(target, filename[, win64_redirect=true|false])

Retrieves information about the specified file, but not the file content. This information is useful if the file is a binary file or particularly large.

The file size returned is the value reported by the Operating System and for certain types of file, such as special files on Linux, and Junctions on Windows, the size may be zero despite the file having content.

This is useful if the file is a binary file or particularly large.

The function takes the following parameters:

  • target – the device or data source against which the request is performed. See also, discovery-dataSource.
  • filename – the name of the file on which to return information.
  • win64_redirect is an optional flag which enables you to specify whether the search for the file should take place in the 32 bit directory if not found in the 64 bit directory. TRUE means search the 32 bit directory, FALSE means do not search the 32 bit directory if the file is not found in the 64 bit directory. The default is TRUE.

64 bit Windows hosts have the following system directories for holding executables, DLLs, and so forth:

  • %windir%\system32 — 64 bit executables and DLLs
  • %windir%\SysWOW64 — 32 bit executables and DLLs


Filenames that do not start with %windir%\system32 or %systemroot%\system32 are never checked for redirection.

On non-Windows and 32 bit Windows systems win64_redirect has no effect.

Returns a DiscoveredFile node with no content attribute.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Discovery 24.1 (On-Premises)