# Commvault End-User Command Line (cvc) Interface Example: find

## Name

find

## Synopsis

find [-c CLIENTNAME] [-i INSTANCENAME] [-bk BACKUPSETNAME] [-sc SUBCLIENTNAME] [-path SOURCEPATH [SOURCEPATH ...] -f FILENAME [-ftime FROMTIME] [-ttime TOTIME]

## Description

Search the backed up data to find a particular backup that you want to restore.

After you find the backup, you can restore the backup.

You can search for backups for a particular backup set, or for a particular subclient.

If you want to perform a point-in-time find, then you must use one of the following options:

- The from time (the start time of the window during which the data was backed up)

- The to time (the end time of the window during which the data was backed up)

- The from and to time (the window during which the data was backed up)

The table lists the options that the software supports.

Note

- Verify that the Index files after backup option on the Configuration tab of the VM group is enabled.

- If you do not specify the backup set and the subclient, then the software performs the find operation on the default backup set.

Option | Description
--- | ---
-c | The CommCell Console client name. The software uses the information that is in the computer registry when you do not specify this option.
-i | The CommCell Console instance name.
-bk | The CommCell Console backup set name. The software uses the DefaultBackupSet when you do not specify this option.
-sc | The CommCell Console subclient name. The software uses the DefaultBackupSet and the default subclient when you do not specify this option.
-path | The path on the source that contains the data that you want to find. You can specify relative paths.
-f | A file that is part of the backup.
-ftime | The start time of the backup window that you specify for a point-in-time find operation. The format is yyyy-mm-dd hh:mm:ss.
-ttime | The end time of the backup window that you specify for a point-in-time find operation. The format is yyyy-mm-dd hh:mm:ss.

## Example

### Perform a Find for a Subclient

The following command searches for a file called example.txt for the data_subclient subclient. In this example, the parameters are listed on the command line.

    cvc> find -c example_client -bk example_backup_set -sc data_subclient -f"example.txt"
    Find List: /tmp/data3/example.txt
    Specifications of Files in the Given path
    name:example.txt
    size:7756
    modified_time:15/09/2016 11:24:51

### Perform a Find for a Backup Set

The following command searches for a file called example.txt for the example_backup_set backup set. In this example, the parameters are listed on the command line.

    cvc> find -c example_client -bk example_backup_set -f"example.txt"
    Find List: /tmp/data3/example.txt
    Specifications of Files in the Given path
    name:example.txt
    size:7756
    modified_time:15/09/2016 11:24:51

### Perform a Find for the Default Backup Set

The following command searches for a file called example.txt in the default backup set. In this example, the parameters are listed on the command line.

    cvc> find -c example_client -f"example.txt"
    Find List:
    /tmp/data3/example.txt
    /tmp//test/example.txt
    Specifications of Files in the Given path
    name:example.txt
    size:7756
    modified_time:15/09/2016 11:24:51
    type:File
    name:example.txt
    size:7756
    modified_time:15/09/2016 11:24:51
    type:File

### Perform a Find for a Specified Time Period

The following command searches for a file called example.txt for a specified time. In this example, the parameters are listed on the command line.

    cvc> find -c example_client -f"example.txt" -ftime "2017-09-24 11:12:13" -ttime "2017-09-26 11:22:18
    Find List:
    /tmp/data3/example.txt
    /tmp//test/example.txt
    Specifications of Files in the Given path
    name:example.txt
    size:7756
    modified_time:15/09/2016 11:24:51
    type:File
    name:example.txt
    size:7756
    modified_time:15/09/2016 11:24:51
    type:File

×

Loading...