File: summain.1.in

package info (click to toggle)
summain 0.18-1
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 220 kB
  • ctags: 153
  • sloc: python: 555; ansic: 119; sh: 60; makefile: 20
file content (46 lines) | stat: -rw-r--r-- 1,419 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
.TH SUMMAIN 1
.SH NAME
summain \- gather file checksums and metadata
.SH SYNOPSIS
.SH DESCRIPTION
.B summain
gathers metadata about files,
and computes their checksums.
It is intended to create a 
.I manifest
of the files.
The manifest can be used to see if something has changed:
a new manifest can be created and compared with the old one with
.BR diff (1).
.PP
The manifest looks like this:
.IP
.nf
Name: foo/bar/foobar
SHA1: 1234123413241324
Mtime: 2010-01-01 02:08:00.127651 +0000
Mode: 1755
.fi
.PP
The filename is URL-encoded to ensure it is purely ASCII.
Mode is in octal.
.PP
Only some inode fields are included.
It does not make sense to compare, for example, the access time,
so that is not included.
.PP
Time stamps are given using microsecond precision,
for the benefit of those filesystems that can support precise timestamps.
(Should be nanosecond, but Python return timestamps as floating point,
and nanosecond precision is too much for the floating point type.)
.PP
The inode and device number fields will not be reported accurately.
Instead, they are normalized so that manifests are useful after the files
have been restored from backups.
Accurate numbers would mean everything seems to have changed.
Normalized means that there will be no differences.
The numbers are reported so that hard links can be checked.
.PP
Directories named on the command line will be recursed automatically.
.SH OPTIONS