qlist backupfiles

Description

This command performs a search operation on backed up files and saves the results to a file. The type of operation is defined in the opType attribute in the XML request file:

Find: Performs a recursive search and returns a list of files and folders. Specify recursion by using asterisks in the path attribute as shown: <paths path="C:\data\**\*" />.
Browse: Performs a search on one directory and returns a list of files and folders in that directory. (The Browse operation is not recursive.)
Versions: Lists all of the versions of a single file.

For the Find and Browse operations, you can limit the results to backed up files for a specific job by using the <jobId> element in the XML request file.

In case of an error, an error code and description are displayed as: "backupfiles: Error errorcode: errordescription"

Usage

qlist backupfiles -af path_to_input_XML_file -dpath path_to_output_XML_file [-tf tokenfile] [-tk token] [-example] [-h]

Options

-af	XML file that contains the request
-dpath	Destination path and file name for the XML output file
-tf	Reads token from a file
-tk	Token string
-example	Sample "find" and "browse" XML requests
-h	Displays help

Diagnostics

Possible exit status values are as follows:

0 - Successful completion.

1 - CLI usage failures, due to the use of an unsupported option or missing argument.

2 - Any other failure.

Examples

For the default subclient, finds all of the files and folders in the C:\data directory and its subdirectories.

qlist backupfiles -af c:\searches\find.xml -dpath c:\results\find_results.xml

XML example for the Find operation:

<databrowse_BrowseRequest opType="Find">
    <entity _type_="0" appName="Windows File System" backupsetName="defaultBackupSet" clientName="vmcs100_cn" subclientName="default"/>
    <queries type="DATA">
        <dataParam>
            <paging pageSize="4294967295" skipNode="0"/>
        </dataParam>
    </queries>
    <mode mode="2"/>
    <paths path="C:\data\**\*" />    
</databrowse_BrowseRequest>

For the default subclient, browses the files and folders in the C:\ directory.

qlist backupfiles -af c:\searches\browse.xml -dpath c:\results\browse_results.xmll

XML example for the Browse operation:

<databrowse_BrowseRequest opType="Browse">
    <entity _type_="0" appName="Windows File System" backupsetName="defaultBackupSet" clientName="vmcs100_cn" subclientName="default"/>
    <mode mode="2"/>
    <queries type="DATA">
        <dataParam>
            <paging pageSize="4294967295" skipNode="0"/>
        </dataParam>
    </queries>
    <paths path="C:\"/>
    <timeRange fromTime="0" toTime="1331280338"/>
</databrowse_BrowseRequest>

For job ID 857 run on the default subclient, browses the files and folders in the C:\ directory.

qlist backupfiles -af c:\searches\find.xml -dpath c:\results\find_results.xml

XML example for the Browse operation for a specific job ID:

<databrowse_BrowseRequest opType="Browse">
    <entity _type_="0" appName="Windows File System" backupsetName="defaultBackupSet" clientName="vmcs100_cn" subclientName="default"/>
    <mode mode="2"/>
    <queries type="DATA">
        <dataParam>
            <paging pageSize="4294967295" skipNode="0"/>
        </dataParam>
    </queries>
    <paths path="C:\"/>
    <timeRange fromTime="0" toTime="1331280338"/>
    <advOptions>
        <advConfig>
            <browseAdvancedConfigBrowseByJob>
                <jobId>857</jobId>
            </browseAdvancedConfigBrowseByJob>
        </advConfig>
    </advOptions>
</databrowse_BrowseRequest>

For the default subclient, lists the versions available for the mydata.txt file.

qlist backupfiles -af c:\searches\versions.xml -dpath c:\results\versions_results.xml

XML example for the Versions operation:

<databrowse_BrowseRequest opType="Versions">
    <entity _type_="0" appName="Windows File System" backupsetName="defaultBackupSet" clientName="vmcs100_cn" subclientName="default"/>
    <mode mode="2"/>
    <paths path="C:\Users\Administrator\Documents\test\mydata.txt"/>
    <queries type="DATA"/>
</databrowse_BrowseRequest>