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
- Creating a shell script
car_tar_gz -S core.8326 > collect_cores.csh
- Assigning execution permission to a shell script
chmod +x ./collect_cores.csh
- 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 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. |
Notes
- 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).