ref: 4cd46e8601a04d2dc4fa91f95f5be4be14943c96
dir: /sys/man/1/history/
.TH HISTORY 1 .SH NAME history \- print file names from the dump .SH SYNOPSIS .B history [ .B -Dabcemnw ] [ .B -fu ] [ .B -d .I dumpfs ] [ .B -t .I snaptag ] [ .B -s .I yyyymmdd ] .I files ... .SH DESCRIPTION .I History prints the names, dates, and sizes, and modifier of all versions of the named .IR files , looking backwards in time, stored in the dump file system. If the file exists in the main tree, the first line of output will be its current state. For example, .IP .EX history /adm/users .EE .PP produces .IP .EX May 14 15:29:18 EDT 2001 /adm/users 10083 [adm] May 14 15:29:18 EDT 2001 /n/dump/2001/0515/adm/users 10083 [adm] May 11 17:26:24 EDT 2001 /n/dump/2001/0514/adm/users 10481 [adm] May 10 16:40:51 EDT 2001 /n/dump/2001/0511/adm/users 10476 [adm] ... .EE .PP The .B -D option causes .IR diff (1) to be run for each adjacent pair of dump files. The options .B -abcemnw are passed through to .IR diff; the little-used .I diff option .B -f is replaced by the functionality described below, and the .B -r option is disallowed. .PP The .B -u option causes times to be printed in GMT (UT) rather than local time. .PP The .B -d option selects some other dump file system such as .IR /n/bootesdump . .PP The .B -t option selects some other snapshot tag within the file system. If not specified, it defaults to the .I main snapshot tag. .PP The .B -f option is accepted but ignored by compatibility with other history implementations. .PP Finally, the .B -s option sets the starting (most recent) date for the output. .SH EXAMPLES Check how often a user has been logged in. .IP .EX history /usr/ches/tmp .EE .SH FILES .B /n/dump .SH SOURCE .B /rc/bin/history .SH SEE ALSO .IR fs (4) , .IR yesterday (1)