Server Commands/GLINE

Current revision as of 02:24, 12 October 2012

Syntax: GLINE [[!][+|-][$<type>]<mask> [[<target>] <expiration> :<reason>]]

G-lines are fairly complicated; therefore, we'll attempt to explain how they work in addition on how to use the command itself.

A G-line can be active or inactive, either locally or globally. It can be a purely local G-line, or global. It can be based on an IP address, hostname or even gcos. In short, there are many variations on the basic G-line. Worse, there is also the concept of a "bad channel", or BADCHAN, that has been tacked onto the G-line subsyetem, when it should have been a separate command in the first place.

! - The "!" prefix is used to forcefully place G-lines that would otherwise be denied by the server for being "too wide" (e.g. affect too many users). The ability to use this prefix has been disabled on DareNET.

[+|-] - Optional. Specifies whether the G-line is to be activated or deactivated.

<$type> - The type argument can be used to G-line user realnames (gcos) by using $R.

<mask> - This may take several forms depending on the type of G-line being placed; user@host for hostnames, #channel for badchannels, and *phrase* for gcos. If not given, or if its not prefixed by "+" or "-", a list of G-lines will be returned. If the "+" or "-" prefixes are used, then the <expiration> and <reason> parameters must also be given, even if the G-line already exists.

<target> - specifies what server(s) the G-line is to be activated/deactivated on. It may be either a server name or * for global. This is rarely used on DareNET due to the fact that O must be used to place global G-lines.

<expiration> - The expiration can be specified either in seconds or as a formatted time (e.g. 2d5m3s).

<reason> - The reason specifies why the user is being G-lined. It will be broadcasted to all IRC operators who have the appropriate SNOMASK and to user(s) being G-lined.

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 O, the change will be forced to be local.

(Return to Main listing of Server Commands)

@@ Line 1: / Line 1: @@
-<pre>GLINE [[!][+|-][$<type>]<mask> [[<target>] <expiration> :<reason>]]</pre>
+'''Syntax:''' <code>GLINE [[!][+|-][$<type>]<mask> [[<target>] <expiration> :<reason>]]</code>
-Sets (+), removes (-) or lists glines (global bans). The target can either be specified as * for a global gline (all servers) or a specific server can be specified for a local gline confined to the specified server. The <type> argument can be used to G-line user Realnames by using $R. The expiration can be specified either in seconds or as a formatted time, eg 2d5m3s (2 days 5 minutes 3 seconds. If the mask would not be permitted due to it being too wide or affecting too many users, the "!" prefix may be used to force the G-line to be set anyway.
-By default, DareNET IRC operators cannot use the "!" prefix, or set global G-lines via the GLINE command (e.g. the server will actually prevent you from doing it). OperServ should be used to do this instead.
+G-lines are fairly complicated; therefore, we'll attempt to explain how they work in addition on how to use the command itself.
+A G-line can be active or inactive, either locally or globally. It can be a purely local G-line, or global. It can be based on an IP address, hostname or even gcos. In short, there are many variations on the basic G-line. Worse, there is also the concept of a "bad channel", or BADCHAN, that has been tacked onto the G-line subsyetem, when it should have been a separate command in the first place.
+'''!''' - The "!" prefix is used to forcefully place G-lines that would otherwise be denied by the server for being "too wide" (e.g. affect too many users). The ability to use this prefix has been disabled on DareNET.
+'''[+|-]''' - Optional. Specifies whether the G-line is to be activated or deactivated.
+'''<$type>''' - The type argument can be used to G-line user realnames (gcos) by using $R.
+'''<mask>''' - This may take several forms depending on the type of G-line being placed; user@host for hostnames, #channel for badchannels, and *phrase* for gcos. If not given, or if its not prefixed by "+" or "-", a list of G-lines will be returned. If the "+" or "-" prefixes are used, then the <expiration> and <reason> parameters must also be given, even if the G-line already exists.
+'''<target>''' - specifies what server(s) the G-line is to be activated/deactivated on. It may be either a server name or * for global. This is rarely used on DareNET due to the fact that O must be used to place global G-lines.
+'''<expiration>''' -  The expiration can be specified either in seconds or as a formatted time (e.g. 2d5m3s).
+'''<reason>''' - The reason specifies why the user is being G-lined. It will be broadcasted to all IRC operators who have the appropriate SNOMASK and to user(s) being G-lined.
+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 O, the change will be forced to be local.
 [[Server Commands|(Return to Main listing of Server Commands)]]