The gversion Utility Program

The gversion Utility Program extracts and prints date and time information from an executable file. By default, gversion prints out the revision date and the release date of the program.

Usage

To use gversion, enter:

gversion [-all] [slot#] [file1] [file2] ...

where

-all

Print all non-zero dates, marked [0]..[9].

slot#

Single digit number of slot to print. The default is to display all time slots. In the examples on the following page, since ccommcore only has one time slot set and the slots are filled in increasing numerical order, the command gversion 0 ccommcore yields the same result as gversion ccommcore which is


ccommcore: Green Hills Software, release 1.8.8
ccommcore: Revision Date Fri Dec 19 13:14:29 1997

However, if asked to print the value of slot 1 which is unstamped, gversion will display an appropriate error message:

ccommcore: Green Hills Software, release 1.8.8
ccommcore has not been time stamped
ccommcore: [m] Fri Dec 19 13:14:30 1997

Note that gversion will display the file modification date for informational purposes when no valid time stamp corresponding to the slot requested can be found.

In -all mode, each date will be preceded by a digit in square brackets called a time stamp. The Revision Date is preceded by [0] and the Release Date is preceded by [6]. For example,

/usr/green/lx: [0] Thu Jul 06 22:48:50 1996
/usr/green/lx: [6] Mon Aug 14 14:32:11 1996
/usr/green/lx: Revision Date Thu Jul 11 21:45:45 1996
/usr/green/lx: Release Date Mon Oct 7 07:47:37 1996

The Revision Date reflects the date of the last modification of the source code that was used to build the program. The Release Date is the date that the particular tape or disk image containing the program was created. All programs on the same tape should have the same Release Date.

Example 1

gversion /usr/green/lx
/usr/green/lx: Revision Date Thu Jul 11 21:45:45 1996
/usr/green/lx: Release Date Mon Oct 7 07:47:37 1996

Example 2

gversion all /usr/green/gversion
/usr/green/lx: [0] Thu Jul 06 22:48:50 1996
/usr/green/lx: [6] Mon Aug 14 14:32:11 1996

The gversion options include:

-help

Display information about all options.

-date

Print the value as a date string. This is the default.


gversion ccommcore
ccommcore: Green Hills Software, release 1.8.8
ccommcore: Revision Date Fri Dec 19 13:14:29 1997

-value

Print the value without converting to date. For example:


gversion -value ccommcore
ccommcore: Green Hills Software, release 1.8.8
ccommcore: [0] 882566069
ccommcore: [1]
ccommcore: [2]
ccommcore: [3]
ccommcore: [4]
ccommcore: [5]
ccommcore: [6]
ccommcore: [7]
ccommcore: [8]
ccommcore: [9]

-mtime

Always print the file modification date. This option must be used with -all. For example:

gversion -mtime -all ccommcore
ccommcore: Green Hills Software, release 1.8.8
ccommcore: [0] Fri Dec 19 13:14:29 1997
ccommcore: [m] Fri Dec 19 13:14:30 1997

-nomtime

Never print the file modification date.

-quiet

Suppress errors for unstamped files.


gversion foo
foo cannot be time stamped

gversion -quiet foo

Previous

Next



Copyright © 1999, Green Hills Software. All rights reserved.