Server Commands/SHUN

Revision as of 07:06, 10 December 2008

Command Token: SU

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

! - The "!" prefix is used to forcefully place Shuns 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 Shun is to be activated or deactivated.

<$type> - The type argument can be used to Shun users whose realname (gcos) matches by using $R.

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

<target> - specifies what server(s) the Shun 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 OperServ must be used to place global Shuns.

<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 Shunned. It will be broadcasted to all IRC operators who have the appropriate SNOMASK.

If the Shun currently exists, a prefix of "+" will cause an inactive Shun to be activated, whereas a prefix of "-" will cause an active Shun to be deactivated. If an attempt is made to modify a Shun set by a U-lined service, such as OperServ, the change will be forced to be local.

(Return to Main listing of Server Commands)

@@ Line 5: / Line 5: @@
 <pre>SHUN [[!][+|-][$<type>]<mask> [[<target>] <expiration> :<reason>]]</pre>
-'''! prefix'''
-The "!" prefix has been disabled on DareNET. It's used to forcefully place SHUNs that otherwise would be denied by the server for being "too wide." If you need to set wide SHUNs, use OperServ instead, or contact the Abuse Team <abuse@darenet.org>.
+'''!''' - The "!" prefix is used to forcefully place Shuns 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.
-If <mask> is not given, or it is not prefixed by "+" or "-", a list of Shuns will be returned. If the "+" or "-" prefixes are used, then the <expiration> and <reason> parameters must also be given, even if the Shun already exists.
+'''[+|-]''' - Optional. Specifies whether the Shun is to be activated or deactivated.
-If <target> is specified, then it MUST match the local server (e.g. the server you are on); otherwise it is implied. By default, the ability to set remote or global Shuns has been disabled for all IRC operators. Instead, OperServ should be used instead. However, such permissions can be granted through OperServ by a network administrator, but this is rarely done
+'''<$type>''' - The type argument can be used to Shun users whose realname (gcos) matches by using $R.
-The <type> argument can be used to Shun user Realnames by using $R. The expiration can be specified either in seconds or as a formatted time (e.g. 2d5m3s).
+'''<mask>''' - This may take two forms depending on the type of Shun being placed; user@host for hostnames, and *phrase* for gcos. If not given, or if its not prefixed by "+" or "-", a list of Shuns will be returned. If the "+" or "-" prefixes are used, then the <expiration> and <reason> parameters must also be given, even if the Shun already exists.
+'''<target>''' - specifies what server(s) the Shun 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 OperServ must be used to place global Shuns.
+'''<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 Shunned. It will be broadcasted to all IRC operators who have the appropriate SNOMASK.
+If the Shun currently exists, a prefix of "+" will cause an inactive Shun to be activated, whereas a prefix of "-" will cause an active Shun to be deactivated. If an attempt is made to modify a Shun set by a U-lined service, such as OperServ, the change will be forced to be local.
 [[Server Commands|(Return to Main listing of Server Commands)]]