car_tar_gz (core archiving function)
- Organization of this page
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.
|
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 through 99)
A temporarily created directory: carYYMMDDhhmm/(YYMMDDhhmm is the creation year, month, date, hours and minutes of the core file).