car_tar_gz [-i executable-file-name] [-f] [-s|-S] [core-file-name] > output-file-name

Collects the core file and the related libraries and outputs to a single archive file. The car_tar_gz command compresses the file and the libraries, by using the gzip command. This command is for UNIX.

-i executable-file-name

Specifies an executable file name.

-f

Acquires files such as the libraries with a path name.

-s

Reports the size (unit: bytes) of an archive file to be output.

In such cases, the archive file is not output.

-S

Outputs a shell script for creating an archive file.

When you specify this option, specify the shell script name in output-file-name.

When you execute the output shell script, the archive file is output.

core-file-name

Specify the core file name. When you omit the specification, core is specified.

output-file-name

Specify a name of the archive file or shell script file.

When creating an archive file

car_tar_gz -f core.8326 > corefile.tar.gz

When checking the size of an archive file

car_tar_gz -s core.8326

When creating an archive file from a shell script

1. Creating a shell script
   car_tar_gz -S core.8326 > collect_cores.csh
   
2. Assigning execution permission to a shell script
   chmod +x ./collect_cores.csh
   
3. Creating an archive file by using the shell script
   ./collect_cores.csh > corefile.tar.gz
   

0:

The command is terminated normally.

1:

The command is terminated abnormally.

When the system outputs the following messages, a normal archive file is not output.

Table 10-2 Error messages output when using the car_tar_gz command

No.	Error message	Explanation
1	usage: car_tar_gz [ -i executable-file ] [ -f ] [ -s | -S ] [ core-file ]	Arguments of the command are invalid.
2	car_tar_gz: inner error!	This is an internal error of the car_tar_gz command.
3	car_tar_gz: cannot create temporary name	A file to be temporarily used cannot be created. Delete or migrate the file car_exec?? (?? is a number from 00 through 99) in the current directory.
4	car_tar_gz: ~ : file not found	A file is not found. Check the executable file specified in the core file and the -i option.
5	car_tar_gz: ~ : not supported platform	The OS is not supported.

• You must assign the write permission to the current directory.
• In the same directory, you cannot concurrently execute the car_tar_Z and car_tar_gz commands for the same core file or different core files having the same creation time.
• The tar and gzip commands must have been installed in the system.
• If you forcibly terminate the car_tar_gz command during execution, temporary files or the directory created by the car_tar_gz command remain behind in the current directory.
  Temporarily created files: car_exec?? (?? is a number from 00 thorough 99)
  A temporarily created directory: carYYMMDDhhmm/(YYMMDDhhmm is the creation year, month, date, hours and minutes of the core file).