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
|
.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "CYPHESIS-TOOLS" "1" "22 October 2006" "" "cyphesis"
.SH NAME
cyconfig, cyconvertrules, cydumprules, cyloadrules, cypasswd \- cyphesis tools
.SH SYNOPSIS
\fB/usr/bin/cyaddrules\fR [ \fB--section:option=value\fR\fI ...\fR ] [ \fBrulesetname atlas-xml-file\fR ]
\fB/usr/bin/cyconfig\fR [ \fB--section:option=value\fR\fI ...\fR ]
\fB/usr/bin/cyconvertrules\fR \fBrule_file\fR
\fB/usr/bin/cydumprules\fR
\fB/usr/bin/cyloadrules\fR [ \fB--section:option=value\fR\fI ...\fR ] [ \fBrulesetname atlas-xml-file\fR ]
\fB/usr/bin/cypasswd\fR [ { \fB-a\fR | \fB-s\fR | \fB-d\fR } \fBaccount\fR ]
.SH "DESCRIPTION"
.PP
The cyphesis tools manage the data and configuration files used by cyphesis.
.PP
The \fBcyaddrules\fR tool uploads Atlas XML rules files into the
a running server. If rules already exist in the server, then the default
attributes are updated, and if the rule has a script associated with it,
then the script is reloaded from file. \fBcyaddrules\fR can
either upload the file given on the command line, or if none is specified it
will upload the rule file for the ruleset specified in the server config,
and any rule files it depends on. \fBcyaddrules\fR is typically
used to add additional rules during rule development without having to
restart the server. Rules can be loaded directly into a running server
using \fBcyaddrules\fR\&.
.PP
The \fBcyconfig\fR program provides an easy scriptable way to
make permanent changes to the server config from the command line.
It works by writing new config options to \fI\&.cyphesis.vconf\fR
in the users home directory, which is read by the server at startup,
and overrides the contents of the main config file. For a description of
the various options that the server takes, please see
\fBcyphesis\fR(1)\&.
.PP
The \fBcyconvertrules\fR program converts Atlas XML rules files
from an older historic format into the format used by cyphesis since
version 0.3.1.
.PP
The \fBcydumprules\fR program dumps rules from the database table
used by the server into a set of Atlas XML rules files. Note that this does
not produce a set of files containing the same rules as those that were loaded
in using \fBcyloadrules\fR because some of the rules in the
rulesets that were not top level may have been overloaded, and do not exist
in the database table. Typically this command will be used to get an updated
copy of the top level ruleset from the server database, and the rest of the
files will be ignored.
.PP
The \fBcyloadrules\fR tool loads Atlas XML rules files into the
database table used by the server. The rules table is read by the
server at startup, so a server restart is typically required after loading
rules. \fBcyloadrules\fR can either load the file given on
the command line, or if none is specified it will load the rule file for
the ruleset specified in the server config, and any rule files it depends on.
Rules can be loaded directly into a running server using
\fBcyaddrules\fR\&.
.PP
The \fBcypasswd\fR tool is used to administrate the accounts table
in the server database.
.SH "OPTIONS"
.PP
The \fBcypasswd\fR can either add a new account, set the password
of an existing account, or remove an account from the database. When no
arguments are given, it prompts for a new admin password for cyphesis.
When run with the \fB-a\fR option, the command prompts for a
password to be entered and an account with the username given by \fBaccount\fR,
and with the password supplied at the prompt is created. When run with the
\fB-s\fR option, the command prompts for a password, and the
existing account with username given by \fBaccount\fR has its password changed to
the new one entered. When run with the \fB-d\fR option, the
account with username given by \fBaccount\fR is removed from the database.
.PP
Whenever the \fBcypasswd\fR prompts for a password, a second
prompt is displayed asking for confirmation of the password. If the two
password entered do not match, the operation is aborted, and no changes are
made to the database.
.SH "AUTHOR"
.PP
Written by Alistair Riddoch.
.SH "REPORTING BUGS"
.PP
Report bugs to <general@worldforge.org>\&.
.SH "COPYRIGHT"
.PP
Copyright 2004 Alistair Riddoch.
.SH "SEE ALSO"
.PP
\fBcyphesis\fR(1),
\fBcyclient\fR(1),
\fBcycmd\fR(1)
|
