Difference between revisions of "2.0/Modules/ns access"

From AnopeWiki
Jump to: navigation, search
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Language|2.0/Modules}}
+
{{Language|2.0/Modules/ns_access}}
{| align="center"
+
{{Syntax|ns_access|NickServ|Anope}}
|-
+
||
+
{| class="wikitable"
+
|{{ModHead}}||'''  ns_access '''
+
|-
+
|{{ModAuth}}||'''  Anope '''
+
|-
+
|}
+
|-
+
|}
+
__NOEDITSECTION__ __NOTOC__ <includeonly>[[Category:Modules]] [[Category:{{#explode:{{SUBPAGENAME}}|/|1}}]]</includeonly>
+
{{Boxes|Description|{{{description|Maintains the access list for a channel.  The access list specifies which users are allowed chanop status or access to ChanServ commands on the channel.  Different user levels allow for access to different subsets of privileges. Any registered user not on the access list has a user level of 0, and any unregistered user has a user access level of -1.}}} }}
+
{{Boxes|Commands|{{{commands|access #channel '''ADD''' mask level
+
access #channel '''DEL''' {mask or entry-num or list}
+
  
access #channel '''LIST''' [mask or list]
+
== <div class="moduleheader">Description</div> ==
 +
Modifies or displays the access list for your nick.  This is the list of addresses which will be automatically recognized by NickServ as allowed to use the nick. If you want to use the nick from a different address, you meed to send an IDENTIFY command to make NickServ recognize you. Services Operators may provide a nick to modify other users' access lists.
  
access #channel '''VIEW''' [mask or list]
 
  
 +
== <div class="moduleheader">Commands</div> ==
 +
access '''ADD''' [nickname] mask
  
::The '''ACCESS ADD''' command adds the given mask to the access list with the given user level; if the mask is already present on the list, its access level is changed to the level specified in the command.  The level specified may be a numerical level or the name of a privilege (egAUTOOP). When a user joins the channel the access they receive is from the highest level entry in the access list. The given mask may also be a channel, which will use the access list from the other channel up to the given level.
+
access '''DEL''' [nickname] mask
  
::The '''ACCESS DEL''' command removes the given nick from the access list.  If a list of entry numbers is given, those entries are deleted.  (See the example for LIST below.) You may remove yourself from an access list, even if you do not have access to modify that list otherwise.
+
access '''LIST''' [nickname]
  
::The '''ACCESS LIST''' command displays the access list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown; for example: ''ACCESS #channel LIST 2-5,7-9'' Lists access entries numbered 2 through 5 and 7 through 9.
+
== <div class="moduleheader">Examples</div> ==
 +
/msg NickServ '''ACCESS ADD''' anyone@*.bepeg.com Allows access to user anyone from any machine in the bepeg.com domain.
  
::The '''ACCESS VIEW''' command displays the access list similar to ACCESS LIST but shows the creator and last used time.
+
/msg NickServ '''ACCESS DEL''' anyone@*.bepeg.com Reverses the previous command.
  
::The '''ACCESS CLEAR''' command clears all entries of the access list.
+
/msg NickServ '''ACCESS LIST''' Displays the current access list.
  
 +
== <div class="moduleheader">Default Configuration</div> ==
  
'''User access levels''' can be seen by using the '''LEVELS''' command; type ''/msg ChanServ HELP LEVELS''}}} }}
+
<div class="code">
 +
<syntaxhighlight lang="cpp">
 +
 
 +
/*
 +
* ns_access
 +
*
 +
* Provides the command nickserv/access.
 +
*
 +
* Used for configuring what hosts have access to your account.
 +
*/
 +
module
 +
{
 +
        name = "ns_access"
 +
 
 +
        /*
 +
        * The maximum number of entries allowed on a nickname's access list.
 +
        * If not set, the default is 32. This number cannot be set to 0.
 +
        */
 +
        accessmax = 32
 +
 
 +
        /*
 +
        * If set, Services will add the usermask of registering users to the access list of their
 +
        * newly created account. If not set, users will always have to identify to NickServ before
 +
        * being recognized, unless they manually add an address to the access list of their account.
 +
        * This directive is optional.
 +
        */
 +
        addaccessonreg = yes
 +
}
 +
command { service = "NickServ"; name = "ACCESS"; command = "nickserv/access"; }
 +
</syntaxhighlight></div>

Latest revision as of 21:26, 9 May 2014

Language

English Español

Service NickServ
Module ns_access
Author Anope

Description

Modifies or displays the access list for your nick. This is the list of addresses which will be automatically recognized by NickServ as allowed to use the nick. If you want to use the nick from a different address, you meed to send an IDENTIFY command to make NickServ recognize you. Services Operators may provide a nick to modify other users' access lists.


Commands

access ADD [nickname] mask

access DEL [nickname] mask

access LIST [nickname]

Examples

/msg NickServ ACCESS ADD anyone@*.bepeg.com Allows access to user anyone from any machine in the bepeg.com domain.

/msg NickServ ACCESS DEL anyone@*.bepeg.com Reverses the previous command.

/msg NickServ ACCESS LIST Displays the current access list.

Default Configuration

/*
 * ns_access
 *
 * Provides the command nickserv/access.
 *
 * Used for configuring what hosts have access to your account.
 */
module
{
        name = "ns_access"
 
        /*
         * The maximum number of entries allowed on a nickname's access list.
         * If not set, the default is 32. This number cannot be set to 0.
         */
        accessmax = 32
 
        /*
         * If set, Services will add the usermask of registering users to the access list of their
         * newly created account. If not set, users will always have to identify to NickServ before
         * being recognized, unless they manually add an address to the access list of their account.
         * This directive is optional.
         */
        addaccessonreg = yes
}
command { service = "NickServ"; name = "ACCESS"; command = "nickserv/access"; }