ca_recover(8) CLIX ca_recover(8)
NAME
ca_recover - Extracts any modified data in the cache when the optical
cartridge is not present or the subordinate file system cannot be mounted
SYNOPSIS
/bin/ca_recover -f dir_location -p dir_location -v odvol [-R] [-P
partition] [-q]
FLAGS
-f dir_location
Extracts the entire modified cached files for the specified
subordinate file system to a directory location (dir_location).
-p dir_location
Extracts the partially modified cached files for the specified
subordinate file system to a directory location (dir_location).
-v odvol
Specifies the volume name.
-R Deletes data instead of saving data.
-P partition
Specifies the partition number of the user space on the cartridge.
This flag is not used with the WORM optical disk.
-q Does not display recovery detailed messages on the console.
DESCRIPTION
The ca_recover command extracts modified files from an active Cache File
System (CAFS) for a specified subordinate file system to a directory
location, if the data cannot be written to the media. The -f flag
extracts the entire modified cached files for the specified subordinate
file system to a directory location (dir_location). The -p flag extracts
the partially modified cached files for the specified subordinate file
system to a directory location (dir_location).
The user will be notified if the ca_recover command needs to be invoked by
way of a CAFS warning message on the console. If no messages display, the
data has been written to the cartridge without any errors.
EXAMPLES
1. To extract modified data from CAFS modified list with a specific
partition, key in the following ca_recover command:
ca_recover -f /tmp/full -p /tmp/part -v my_vol -P 7.3
2/94 - Intergraph Corporation 1
ca_recover(8) CLIX ca_recover(8)
2. To indicate that the data is deleted without saving or displaying,
specify the volume name (my_vol) by keying in the following ca_recover
command:
ca_recover -R -v my_vol -q -P 7.3
NOTES
The dir_location (directory location) must exist before issuing the
ca_recover command.
A CAFS warning message displays on the console when the ca_recover command
needs to be issued for a specific subordinate file system. The CAFS
warning message displays on the console every five minutes until the
ca_recover command is invoked for the specified subordinate file system,
or the subordinate file system is mounted.
The ca_recover command cannot be invoked on a mounted subordinate file
system.
The ca_recover command requires superuser privileges.
CAUTION
If the keyword RECOVER is set to no in the configuration file, no data may
be recovered from cache and the data that did not write to the cartridage
successfully will be deleted.
DIAGNOSTICS
The following is a list of common error messages and their meanings:
ca_recover: Only Inode information is available for my_file
An error occurred because there was no data associated within the
modified CAFS list that pertains to this file. The only
information that could be extracted from my_file file is the inode
information.
ca_recover: Nothing to recover for odvol: my_vol, par: 7.3
An error occurred because there was no data in the modified list
for the odvolume and partition specified.
ca_recover: CAFS is stopped.
An error occurred because CAFS must be activated prior to
recovering data from the cache partitions.
EXIT VALUES
2 Intergraph Corporation - 2/94
ca_recover(8) CLIX ca_recover(8)
The ca_recover command exits with a value of 0 if successful. If
unsuccessful, it exits with a nonzero value.
RELATED INFORMATION
Commands: ca_config(8), cafsfsck(8), ca_mnt_done(8), ca_merge(8)
2/94 - Intergraph Corporation 3