car_tar_Z (core archiving)
- Organization of this page
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.
|
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)