• Loading...
This is unapproved DRAFT documentation (other versions).

discovery.listDirectory

Skip to end of metadata
Go to start of metadata
Space Search

Searching Working

Table of Contents

discovery.listDirectory(target, path[, win64_redirect=true|false]) – (7.3 and later)

Retrieves the directory listing of the directory specified by the path on the specified target. You cannot use wildcards in the path. Returns a list of DiscoveredDirectoryEntry nodes.

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

win64_redirect is an optional flag which enables you to specify whether the search 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 directory is not found beneath the 64 bit directory. The default is TRUE.

Paths 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.

The win64_redirect flag is new in 8.2.

If the call fails, it returns none and records the failure reason in the DirectoryListing node.

The target node may be one of the following:

  • Host
  • DiscoveryAccess
  • DiscoveredDirectoryEntry
  • DiscoveredFQDN
  • DiscoveredHBA
  • DiscoveredListeningPort
  • DiscoveredNetworkConnection
  • DiscoveredNetworkInterface
  • DiscoveredProcess
  • DiscoveredSNMPRow
  • DiscoveredWMI
  • SQLResultRow
  • DirectoryListing
  • DiscoveredPackages
  • DiscoveredSNMPTable
  • DiscoveredWMIQuery
  • FQDNList
  • HBAInfoList
  • IntegrationResult
  • InterfaceList
  • NetworkConnectionList
  • ProcessList
  • DeviceInfo
  • DiscoveredCommandResult
  • DiscoveredFile
  • DiscoveredPatches
  • DiscoveredRegistryValue
  • DiscoveredSNMP
  • HostInfo

Restrictions

  1. On Windows systems, owner and group information is not recovered.
  2. Group names which include spaces are not supported.
  3. Config.sys is not listed as a system file.
  4. DirectoryListing nodes are not created for empty Windows directories.
Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.