file
For each file in the file system, you can create a corresponding file object and inspect its properties. inspectors are also provided to look at version data of executable files.Note: File systems that do not maintain the creation or last accessed times will often return the last modification time when queried for the creation or last accessed times or files. Modification times are preserved when files are copied. Thus, it is not uncommon to see a file that appears to have been modified before it was created.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Creation
Returns a global object corresponding to the WinCE web browser installed on the Client Windows Mobile device. Windows Embedded CE uses IE, which has been optimized for WinCE devices.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Red Hat, SUSE, Solaris |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
This inspector is available in relevance subsitution action processing. It returns a file object with the given name from the client's download folder.
This is equivalent to:
file "name" of download folder
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Returns a file object, corresponding to the full pathname provided in <string>, to be read in the specified encoding.
Ensure not to specify any encoding for file
objects already created in previous steps of the relevance expression. For example, the following expression:
- Q: (file "aaa.txt" of folder "c:\test") of encoding "Windows-1252"
does not work as expected and the specified encoding will be ignored because the file object representing "C:\test\aaa.txt" s created first in the local encoding with the expression enclosed parenthesis, and so the subsequent encoding
expression makes no sense and is ignored.
The correct expression to evaluate to read the file "C:\test\aaa.txt" in "Windows-1252" encoding is:
- Q: file "aaa.txt" of folder "c:\test" of encoding "Windows-1252"
Note: If the file to open, using the encoding
object, has a BOM, it will still be opened using the encoding indicating the BOM.
Version | Platforms |
---|---|
9.5.5.193 | AIX, Debian, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns a file object for the named file located in the folder.Example: exists file whose (name of it contains ".pdf") of folder "name" - Returns True
if some file in the folder has a name including the string ".pdf".
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Returns a list of files ending in "xxxx". Typically used to identify a dotted extension. Equivalent to a wildcard search for "*xxxx".Example: files ending in ".a" of folder "/usr/lib" - Returns a list of files with the specified ending, such as: /usr/lib/libcpp_kext.a, /usr/lib/libfl.a, /usr/lib/libioabc.a, and others.
Version | Platforms |
---|---|
8.0.584.0 | Mac |
Iterates through the files of a folder returning file objects. When combined with a whose clause you can select files with specific properties. See file.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Iterates through the files of a folder returning file objects whose name matches the wildcard string provided in the name parameter. A wildcard string uses an asterisk to stand for any number of characters (incuding zero), and a question mark to stand for exactly one character. Thus A??.txt would match All.txt and AXE.txt but not all.txt or a.txt. See example below.Example: Number of find files "siteico.bmp" of client folder of current site = 3 - Returns True
if there are 3 files matching the wildcard pattern siteico.bmp.Example: names of find files "*.exe" of windows folder - Returns a list of the names of all the executable programs in the Windows folder.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Returns a file object representing the image file used to launch the process. In some cases, this property may not exist. For example, the "System" process does not have an image file.
- Q: pathname of image file of process "FixletDebugger.exe"
- A: C:\Program Files (x86)\BigFix Enterprise\BES Console\QnA\FixletDebugger.exe
Version | Platforms |
---|---|
8.0.584.0 | Windows |
9.5.3.211 | Mac |
9.5.5.193 | Debian, Red Hat, SUSE, Solaris, Ubuntu |
9.5.13.130 | Raspbian |
Each site has a masthead, and the masthead is saved into the site data folder upon successful creation. This property returns a file object that corresponds to the copy in the site data folder.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Returns the file with the path specified by <string> relative to the given <folder>. For example: relative file "Safari.app/Contents/MacOS/Safari" of applications folder - Returns the concatenation of the specified folder and the given path, /Applications/Safari.app/Contents/MacOS/Safari.
Version | Platforms |
---|---|
8.0.584.0 | Mac |
Returns an object corresponding to a 64 bit file with pathname specified by <string>. On a 32-bit computer, this is equivalent to a normal file inspector, but on a 64-bit machine, this inspector returns an object that has filesystem redirection disabled.
Version | Platforms |
---|---|
8.0.584.0 | Windows |
Properties
Returns the numeric value of the byte located at the offset specified by number within the file. Byte 0 of the file is the first byte.Example: byte 0 of file "C:\test.txt" - Returns the first byte in the specified file.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Returns the drive associated with the specified file. On Macintosh computers, this returns a <volume> object.On *nix computers, this returns a <filesystem> object.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Red Hat, SUSE, Solaris |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Returns a key and its value from the given structured text file. It iterates over lines that start with the key name (as specified by <string>) followed by an = or : character. When searching, white space is ignored.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
The total length of the data and resource forks.Example: Length of data fork of file "Microsoft Word" of folder "Microsoft Office X" of Applications folder is greater than 100000 - Returns True
if the data fork of the system file is greater than the specified amount.
Version | Platforms |
---|---|
8.0.584.0 | Mac |
Iterates over all the lines of the given file. Note that each line is truncated to 2048 bytes and the remaining characters are moved to the next line.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Returns an object that can be used to search for a string in the specified file that might be locked because it is concurrently opened for writing by another application.
You are supposed to use this inspector to access files that are only being appended to, such as log files, because the files can be changed while the inspector reads them. Otherwise the results can be unpredictable.
This inspector cannot read all kinds of locked files. It fails to open a file if another application has opened the file in an exclusive mode, that is, without allowing others to read the file.
The inspector does not override the access mode or the sharing flag specified to open the file by another application.
Version | Platforms |
---|---|
9.5.7.90 | AIX, Debian, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns a key and its value from the given structured text file that might be locked because it is concurrently opened for writing by another application. It iterates over lines that start with the key name (as specified by <string>) followed by an = or : character. When searching, white space is ignored.
You are supposed to use this inspector to access files that are only being appended to, such as log files, because the files can be changed while the inspector reads them. Otherwise the results can be unpredictable.
This inspector cannot read all kinds of locked files. It fails to open a file if another application has opened the file in an exclusive mode, that is, without allowing others to read the file.
The inspector does not override the access mode or the sharing flag specified to open the file by another application.
Version | Platforms |
---|---|
9.5.7.90 | AIX, Debian, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns the nth line (specified by <integer>) from the given file that might be locked because it is concurrently opened for writing by another application.
You are supposed to use this inspector to access files that are only being appended to, such as log files, because the files can be changed while the inspector reads them. Otherwise the results can be unpredictable.
This inspector cannot read all kinds of locked files. It fails to open a file if another application has opened the file in an exclusive mode, that is, without allowing others to read the file.
The inspector does not override the access mode or the sharing flag specified to open the file by another application.
Version | Platforms |
---|---|
9.5.7.90 | AIX, Debian, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns all the lines containing the specified string and belonging to the given file that might be locked because it is concurrently opened for writing by another application.
You are supposed to use this inspector to access files that are only being appended to, such as log files, because the files can be changed while the inspector reads them. Otherwise the results can be unpredictable.
This inspector cannot read all kinds of locked files. It fails to open a file if another application has opened the file in an exclusive mode, that is, without allowing others to read the file.
The inspector does not override the access mode or the sharing flag specified to open the file by another application.
Version | Platforms |
---|---|
9.5.7.90 | AIX, Debian, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Iterates over all the lines of the specified file that might be locked because it is concurrently opened for writing by another application. Note that each line is truncated to 2048 bytes and the remaining characters are moved to the next line.
You are supposed to use this inspector to access files that are only being appended to, such as log files, because the files can be changed while the inspector reads them. Otherwise the results can be unpredictable.
This inspector cannot read all kinds of locked files. It fails to open a file if another application has opened the file in an exclusive mode, that is, without allowing others to read the file.
The inspector does not override the access mode or the sharing flag specified to open the file by another application.
Version | Platforms |
---|---|
9.5.7.90 | AIX, Debian, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns the lines starting with the specified string and belonging to the given file that might be locked because it is concurrently opened for writing by another application.
You are supposed to use this inspector to access files that are only being appended to, such as log files, because the files can be changed while the inspector reads them. Otherwise the results can be unpredictable.
This inspector cannot read all kinds of locked files. It fails to open a file if another application has opened the file in an exclusive mode, that is, without allowing others to read the file.
The inspector does not override the access mode or the sharing flag specified to open the file by another application.
Version | Platforms |
---|---|
9.5.7.90 | AIX, Debian, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns a named section of the specified file that might be locked because it is concurrently opened for writing by another application. It is useful for locating sections of 'ini' files. Section names are delimited by square bracket characters '[section name]'.
You are supposed to use this inspector to access files that are only being appended to, such as log files, because the files can be changed while the inspector reads them. Otherwise the results can be unpredictable.
This inspector cannot read all kinds of locked files. It fails to open a file if another application has opened the file in an exclusive mode, that is, without allowing others to read the file.
The inspector does not override the access mode or the sharing flag specified to open the file by another application.
Version | Platforms |
---|---|
9.5.7.90 | AIX, Debian, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Iterates over all the lines of the given file, ignoring encoding errors. Note that each line is truncated to 2048 bytes and the remaining characters are moved to the next line.
Version | Platforms |
---|---|
10.0.0.133 | AIX, Debian, Mac, Raspbian, Red Hat, SUSE, Solaris, Ubuntu, Windows |
Returns a named section of a file. Useful for locating sections of 'ini' files. Section names are delimited by square bracket characters '[section name]'.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
9.5.13.130 | Raspbian |
Returns the sha2-384 of the file.
- Q: sha2_384 of file "/etc/passwd"
- A: 8bdadbaff533a5b10d2da7929783a76cc9d9ad9a53825aade38776dba07821996c96db90d20e7b6fb502ddd2462701d4
Version | Platforms |
---|---|
9.0.586.0 | AIX, Debian, HP-UX, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns the sha2-512 of the file.
- Q: sha2_512 of file "/etc/passwd"
- A: ed80a58904b3e73b4b70a11d387f5c18df016fe9c42c36c3f7b265a4e9304d7cd5f040900df25db971846167ba06cfc82c210dc2305c98dab76b09b08f7d6f1f
Version | Platforms |
---|---|
9.0.586.0 | AIX, Debian, HP-UX, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns the sha2-384 of the file.
- Q: sha384 of file "/etc/passwd"
- A: 8bdadbaff533a5b10d2da7929783a76cc9d9ad9a53825aade38776dba07821996c96db90d20e7b6fb502ddd2462701d4
Version | Platforms |
---|---|
9.1.1065.0 | AIX, Debian, HP-UX, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Returns the sha2-512 of the file.
- Q: sha512 of file "/etc/passwd"
- A: ed80a58904b3e73b4b70a11d387f5c18df016fe9c42c36c3f7b265a4e9304d7cd5f040900df25db971846167ba06cfc82c210dc2305c98dab76b09b08f7d6f1f
Version | Platforms |
---|---|
9.1.1065.0 | AIX, Debian, HP-UX, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |
Opens the file as a sqlite database. This is a read-only
SQLite connection. If the connection is successful, the path name of the database is displayed.
Multiple Processes and Multiple Connections
SQLite allows multiple processes to have the database file open at once, and for multiple processes to read the database at once. However, when any process wants to write, it must lock the entire database file for the duration of its update (usually a few milliseconds).
- Q: rows of statement "select count(*) from Artist" of sqlite database of file "chinook.db"
- A: 275
Version | Platforms |
---|---|
9.0.586.0 | AIX, Debian, HP-UX, Mac, Red Hat, SUSE, Solaris, Ubuntu, Windows |
9.5.13.130 | Raspbian |