accurev hist [ -t <transaction-range> ] [ -s <stream> ] [ -c <comment> ]
[ -u <users> [ --exclude_users ] ]
[ -k <transaction-kinds> [ --exclude_kinds ] ]
[ -f <format(s)> ] [ --show_historic_cpk ]
{ -a | <element-list> | [ -Fx ] -l <list-file> | -e <eid> }
[ -p <depot-name> ] [ -R ]The hist command displays part or all of the transaction history of one or more elements. For each transaction, it reports the creation time, who made changes, comments for each version, etc. For each version involved in a transaction, it reports the virtual version, the real version, the transaction number, the transaction time, who created the version and how, and the comment.Display only transaction(s) whose comments contain the specified string. (The string matching is case-insensitive.) Enclose the string in quotes to ensure that hist interprets it as a single command-line argument.Operate on the element with the specified element-ID. If you also specify a <list-file> or <element-list>, it is ignored.-p <depot-name>Recurse into each directory element specified and continue to show transaction history within. The -R option requires at least one element or the -l option. The -R option cannot be used with the -a option.-s <stream>-3: ("third-party") For issue numbers associated with a version, display the third-party ITS key and value for the issue.
-e: (“expanded”) Display more detail for promote transactions: information on the transaction(s) in the current workspace (keep, move, etc.) that recorded the change(s) being promoted.
-i: ("issue") Display issues related to a version of an element at the time of the specified transaction. If a version is not currently the head of an issue, but was at the time of the transaction, the issue is displayed with an attribute historic_only=true. This attribute is not displayed if the version is currently the head and was also the head at the time of the transaction.
-v: (“verbose”) For keep and add transactions, include the modification time, checksum, file size, data type (text or binary), and depot-relative pathname. cpk transactions are listed as add or remove, followed by details of the cpk add or cpk remove operation.
(You can use -fev to display both expanded and verbose information.)
-l: (“list”) For each transaction, show only the path of the element. For move transactions, only the destination is shown.
-s: (“status”) If the displayed version of the element is in the default group of the stream specified with -s (default: workspace stream), list it with “(member)”. This option is intended to be used in combination with -t, when you’re examining a transaction listed by translist.
-t: (“transaction”) Display just the header line, including the transaction number.
-c: (“csv”) Display header information as comma-separated values. The output includes comments provided at Keep or Promote time. Note: This option is valid only in conjunction with the -t format option.
-x: (“XML”) Display results in XML format.-l <list-file>Process the elements listed in <list-file>. This must be a text file, with one element name per line. Extra whitespace is not allowed; make sure there are no empty lines and no leading or trailing white space around the filenames. Wildcards are not expanded. There is no provision for comment lines in the file.If you use this option, any <element-list> specified is silently ignored.One or more element names, separated by whitespace. If you also specify a <list-file> using the –l option, this <element-list> is silently ignored.Display only the transactions of the specified kind(s). Valid values are:
add, archive, chstream, co, defcomp, defunct,
demote_from, demote_to, dispatch, eacl, keep, move,
mkstream, promote, purge, unarchive, undefunctNote: When you use -k defcomp, AccuRev returns transactions of the following types, all of which are related to setting include/exclude rules:Note that you cannot use -k to filter these transaction types directly.Use in conjunction with the -k option to indicate that the output should display all kinds of transactions except for the named kind(s).You may specify multiple users using the -u option by separating the usernames with commas. If any of the names contains a space, place double quotes around the entire list of names.Use in conjunction with the -u option to indicate that the output should display transactions executed by all users except for the named user(s).The second form specifies transactions that took place in the specified interval; the optional suffix truncates the listing after the most recent <count> transactions. You may need to use quotes in composing the argument following -t; the entire argument must be interpreted by the command shell as a single token. The command output depends on the order of the time-specs; list the most recent time-spec first to show the results in order from most recent to least recent. Reverse the order of the time-specs to reverse the order of the output.
transaction 113; promote; 2007/02/19 17:55:55 ; user: john
\.\src\brick.h 13/2 (16/2)
# add RIVER
version 16/2 (16/2)
ancestor: (16/1)
# remove ALLOCSIZE
version 16/1 (16/1)
ancestor: (15/1)Note that the output of this command can be in XML format if you specify -fex instead of -fe at the command line. The <streams> element details all the dynamic streams and workspace streams involved in the reported transaction(s). A transaction’s timestamp (time attribute of the XML element <transaction>) is reported as the number of seconds since Jan. 1, 1970 UTC. Special Field Types describes a technique for converting this timestamp into a human-readable string.Important! If you have been parsing the XML output from the hist command, you will need to check that you are getting the correct <stream> tag, since that tag now appears within both the <transaction> and the <streams> tags. The content of the new <stream> tag will vary depending on the AccuRev command recorded in the transaction.Display issues related to a version of an element at the time of promote transactions, and format the output in XML. Note the <historic_only> tag at the end, indicating that the version is no longer the head, but was at the time of the transaction.Display all AccuWork ("dispatch") transactions in XML format, using verbose mode. Note that any cpk add and cpk remove transactions are flagged in the XML output with cpk= attributes in the <transaction> tag.
| Micro Focus |