# 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

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