File: usage.cc

package info (click to toggle)
stealth 4.04.00-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,540 kB
  • sloc: cpp: 2,759; sh: 151; makefile: 111; ansic: 52
file content (121 lines) | stat: -rw-r--r-- 5,526 bytes parent folder | download | duplicates (5)
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
#include "options.ih"

void Options::usage(std::string const &progname)
{
    cout <<
        progname << " V" << Icmbuild::version << "\n"
        "SSH-based Trust Enhancement Acquired through a Locally Trusted "
                                                                    "Host\n"
        "Copyright (c) GPL " << Icmbuild::years << "\n"
        "\n"
        "Usage 1 (activation modes):\n"
        "   " << progname << " [options] policy\n"
        "Where:\n"
    "   [options] - optional arguments (short options between parentheses,\n"
    "               option descriptions starting with (C) can only be used\n"
    "               on the command-line and are ignored when specified in "
                                                                    "the\n"
    "               policy file).\n"

    "      --daemon (-d) <uds>: (C) run as a background (daemon) process.\n"
    "               <uds> is the location of the Unix Domain Socket that is\n"
    "               used for communication with the stealth daemon process\n"

    "      --dry-run: (C) no integrity scans or reloads are performed, but\n"
    "               are assumed OK. Remaining tasks are normally performed\n"

    "      --log (-L) <file-spec>: log messages are appended to "
                                                        "`<file-spec>'.\n"
    "               If <file-spec> does not exist, it is first created \n"

    "      --logmail: mail is logged (requires --log or --syslog)\n"

    "      --max-size value[BKMG]: files retrieved by GET may at most\n"
    "               have `value' bytes (B), Kbytes (K), Mbytes (M), "
                                                            "Gbytes (G).\n"
    "               By default: 10M; The default unit is `B'\n"

    "      --no-mail: mail is not sent. By default mail is sent as "
                                                                "configured\n"
    "               in the policy-file (--logmail can be specified "
                                                             "independently\n"
    "               from --no-mail)\n"

    "      --parse-policy-file (-p): (C) parse the policy file, no further "
                                                                "actions.\n"
    "               Specify once to see the numbered commands,\n"
    "               twice to see the policy file parsing steps as well.\n"
    "               Results to std output.\n"

    "      --random-interval (-i) value: start integrity scans within\n"
    "               a random interval of `value' seconds (minutes if an `m'\n" 
    "               is appended to the specified value).\n"
    "               Requires --repeat.\n"

    "      --repeat value: start an integrity scan every `value' seconds\n"
    "               (minutes if an `m' is appended to the specified value).\n"

    "      --run-command (-r) value: (C) only execute command #`value'\n"
    "               (not available in combination with --daemon)\n"

    "      --skip-files (-s) <file-spec>: skip the integrity checks of the\n"
    "               files having their absolute path names listed in "
                                                            "`<file-spec>'\n"

    "      --stdout (-o): messages are (also) written to stdout\n"
    "               (not available in combination with --daemon)\n"

    "      --syslog: write syslog messages\n"

    "      --syslog-facility fac:  syslog facility to use. By default "
                                                                "DAEMON\n"

    "      --syslog-priority pri:  syslog priority to use. By default "
                                                                "NOTICE\n"

    "      --syslog-tag tag: identifier prefixed to syslog messages. By\n"
    "               default `" << s_defaultSyslogIdent << "')\n"

    "      --time-stamp <type>: the time-stamps to use. By default UTC.\n"
    "               (does not apply to syslog-timestamps)\n"

    "      --verbosity (-V) value: determines the amount of logged "
                                                            "information.\n"
    "               Requires --log or --syslog:\n"
    "                   0: nothing is logged\n"
    "                   1: mode reports and policy commands\n"
    "                   2: also: ipc commands and actions\n"
    "                   3: also: integrity scan informative messages\n"

    "   policy: location of the policy file\n"
    "\n"

    "Usage 2 (IPC modes, all options are command-line only):\n"
    "   " << progname << 
            " {--reload,--rerun,--resume,--suspend,--terminate} <uds>\n"
    "Where:\n"
    "      --reload: reload a " << progname << " process's policy and "
                                                            "skip-file\n"
    "                   files\n"
    "      --rerun: start an integrity scan\n"
    "      --resume: resume " << progname << " after --suspend\n"
    "      --suspend: suspend " << progname << "'s activities\n"
    "                   to continue: --resume; to end: --terminate\n"
    "      --terminate: terminate the " << progname << " daemon\n"
    "   <uds>: location of the Unix Domain Socket to connect to.\n"
    "\n"
    "Usage 3 (support mode, all options are command-line only)\n"
    "   " << progname << " {--help,--version}\n"
    "Where:\n"
    "      --help (-h):    provide this help and terminate\n"
    "      --version (-v): show version information and terminate\n"

    "\n";
}