car_tar_Z (core archiving)

Format

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

Function

This command gathers a core file and its related libraries and outputs them to a single archive file. The car_tar_Z command compresses the file and the related libraries by using the compress command. This command is for UNIX only.

Arguments

-i executable-file-name
Specifies the name of an executable file.
-f
Collects library and other files, along with their path names.
-s
Reports the size (in bytes) of the archive file that would be output (but without outputting the archive file).
-S
Outputs a shell script for creating the archive file.
When you specify this option, specify a shell script name for output-file-name.
To output the archive file, you must execute the output shell script.
core-file-name
Specifies the name of a core file. If omitted, core is assumed.
output-file-name
Specifies a file name for the archive file or shell script.

Input examples

Create an archive file:

car_tar_Z -f core.8326 > corefile.tar.Z

Check the size of an archive file:

car_tar_Z -s core.8326

Create an archive file from a shell script:
  1. Create a shell script.
    car_tar_Z -S core.8326 > collect_cores.csh
  2. Assign execution rights to the shell script.
    chmod +x ./collect_cores.csh
  3. Execute the shell script and create an archive file.
    ./collect_cores.csh > corefile.tar.Z

Return values

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

Output messages

If any of the messages described below is issued, a normal archive file was not output.

Table 10-3 Error messages output by the car_tar_Z command

No.Error messageExplanation
1usage: car_tar_Z [ -i executable-file ] [ -f ] [ -s | -S ] [ core-file ]A command argument is invalid.
2car_tar_Z: inner error!An internal error occurred in the car_tar_Z command.
3car_tar_Z: cannot create temporary nameA temporary file cannot be created.
Either delete or move the file car_exec?? (where ?? is an integer in the range 00 to 99) located in the current directory.
4car_tar_Z: (omitted): file not foundFile was not found.
Check the core file and the executable file specified by the -i option.
5car_tar_Z: (omitted): not supported platformThe OS is not supported.

Notes