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:
- Create a shell script.
car_tar_Z -S core.8326 > collect_cores.csh
- Assign execution rights to the shell script.
chmod +x ./collect_cores.csh
- 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 message | Explanation |
---|
1 | usage: car_tar_Z [ -i executable-file ] [ -f ] [ -s | -S ] [ core-file ] | A command argument is invalid. |
2 | car_tar_Z: inner error! | An internal error occurred in the car_tar_Z command. |
3 | car_tar_Z: cannot create temporary name | A 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. |
4 | car_tar_Z: (omitted): file not found | File was not found. Check the core file and the executable file specified by the -i option. |
5 | car_tar_Z: (omitted): not supported platform | The OS is not supported. |
Notes
- You must have write permission to write data into the current directory.
- You cannot execute the car_tar_Z and car_tar_gz commands concurrently under the same directory for the same core file or for core files that have the same creation time.
- The tar command and the compress command must both be installed in the system.
- If the car_tar_Z command is terminated forcibly, temporary files and directories created by it remain in the current directory.
Temporary files: car_exec?? (where ?? is an integer in the range 00 to 99)
Temporary directory: carYYMMDDhhmm/ (where YYMMDDhhmm is the date and time the core file was created)