From: Kevin L. Mitchell Date: Thu, 4 May 2000 18:21:48 +0000 (+0000) Subject: Author: Kev X-Git-Url: http://git.pk910.de/?a=commitdiff_plain;h=0eb7c17daea2382418c5a1458b66b3bb451bcfd6;p=ircu2.10.12-pk.git Author: Kev Log message: Update JUPE documentation, write GLINE documentation; please feel free to refine these documents ;) git-svn-id: file:///home/klmitch/undernet-ircu/undernet-ircu-svn/ircu2/trunk@237 c9e4aea6-c8fd-4c43-8297-357d70d61c8c --- diff --git a/ChangeLog b/ChangeLog index c94168f..9ef36ed 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2000-05-04 Kevin L. Mitchell + * doc/readme.gline: describe the syntax of the GLINE command + + * doc/readme.jupe: update to reflect a couple of changes to JUPE + * ircd/gline.c: don't propagate local changes * ircd/jupe.c: don't propagate local changes @@ -1132,7 +1136,7 @@ # # ChangeLog for ircu2.10.11 # -# $Id: ChangeLog,v 1.134 2000-05-04 18:09:46 kev Exp $ +# $Id: ChangeLog,v 1.135 2000-05-04 18:21:48 kev Exp $ # # Insert new changes at beginning of the change list. # diff --git a/doc/readme.gline b/doc/readme.gline new file mode 100644 index 0000000..deb48b2 --- /dev/null +++ b/doc/readme.gline @@ -0,0 +1,67 @@ +GLINE documentation, last updated on 18 Mar 2000 + +For an ordinary user, the syntax is: + + GLINE [] + +If is given, and if a G-line for that server exists, all the +information about that G-line is displayed. If is not given, +an error is returned. + +For an operator, the syntax is: + + GLINE [[+|-] [[] :]] + +If is not given, or if it is not prefixed by "+" or "-", the +operation is exactly the same as if it were issued by an ordinary +user, except that a list of all G-lines may be returned. If the "+" +or "-" prefixes are used, the arguments , , and + must be given, even if the G-line already exists. If + is "*" and the currently existing G-line is a local G-line, +the local G-line will be erased and recreated with the parameters +given, as described below. Otherwise, if the G-line currently exists, +a prefix of "+" will cause an inactive G-line to be activated, whereas +a prefix of "-" will cause an active G-line to be deactivated. If an +attempt is made to modify a G-line set by a U-lined service such as +Uworld, the change will be forced to be local. + +If the G-line does not already exist, it is created. The +parameter is used to select whether the G-line is only to apply to a +single server (which need not be the local server) or to the whole +network; if is not given, it is assumed to be the local +server. This could be useful if a single particular link is having +problems, for instance. The parameter is a number of +seconds, not to exceed 7 days, for the G-line to exist. The +argument is mandatory and should describe why this particular G-line +was placed. + +For a server, the syntax is: + + GL (+|-) : + +The may be a server numeric or the character "*", for a +globally scoped G-line. The argument is a server name, and +must be prefixed by one of "+" (to indicate an active G-line) or "-" +(to indicate an inactive G-line). The parameter is a +total number of seconds the G-line is to live for, and is +used for versioning. Since GLINEs are propagated during netbursts, +there must be some way of resolving conflicting states, which is the +reason for this argument, and is also the reason G-lines cannot be +deleted, only deactivated. The parameter indicates the +reason the G-line was placed. + +If a GLINE is received with a of "*", any G-lines with local +scope are deleted, in preference for the globally scoped version. If +the G-line already exists, the values of are compared; if +the received is less than the stored , the existing +G-line is resent to the server from which the GLINE message was +received; otherwise, the G-line is activated or deactivated, depending +on the prefix. If the G-line does not currently exist, it is +created with the parameters given. + +For a U-lined server, this syntax should be used: + + GL + : + GL - + +The parameter will be assumed to be 0. diff --git a/doc/readme.jupe b/doc/readme.jupe index da36f9a..e34dfe7 100644 --- a/doc/readme.jupe +++ b/doc/readme.jupe @@ -10,7 +10,7 @@ all un-expired jupes are displayed. For an operator, the syntax is: - JUPE [[+|-] [ :]] + JUPE [[+|-] [[] :]] If is not given, or if it is not prefixed by "+" or "-", the operation is exactly the same as if it were issued by an ordinary @@ -22,13 +22,15 @@ given, as described below. Otherwise, if the jupe currently exists, a prefix of "+" will cause an inactive jupe to be activated, whereas a prefix of "-" will cause an active jupe to be deactivated. -If the jupe does not already exist, it is created; is used to -select whether the jupe is only to apply to a single server (which -need not be the local server) or to the whole network. This could be -useful if a single particular link is having problems, for instance. -The parameter is a number of seconds, not to exceed 7 -days, for the jupe to exist. The argument is mandatory and -should describe why this particular jupe was placed. +If the jupe does not already exist, it is created. The +parameter is used to select whether the jupe is only to apply to a +single server (which need not be the local server) or to the whole +network; if is not given, it is assumed to be the local +server. This could be useful if a single particular link is having +problems, for instance. The parameter is a number of +seconds, not to exceed 7 days, for the jupe to exist. The +argument is mandatory and should describe why this particular jupe was +placed. For a server, the syntax is: