car_tar_gz (core archiving function)

Format

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

Function

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.

Arguments

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

Input example

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

Return values

0:
The command is terminated normally.
1:
The command is terminated abnormally.

Output messages

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 messageExplanation
1usage: car_tar_gz [ -i executable-file ] [ -f ] [ -s | -S ] [ core-file ]Arguments of the command are invalid.
2car_tar_gz: inner error!This is an internal error of the car_tar_gz command.
3car_tar_gz: cannot create temporary nameA 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.
4car_tar_gz: ~ : file not foundA file is not found.
Check the executable file specified in the core file and the -i option.
5car_tar_gz: ~ : not supported platformThe OS is not supported.

Notes