This command is used to manipulate the access to your channel that different users have. This command accepts 2 to 4 arguments, the channel to apply the access changes or viewing to, the sub command you wish to use, the mask you want to use with the command (often just a nickname) and the the change you wish to make or entry you wish to view, if applicable.
Of the 3 different ways to manipulate channel access entries, this one is roughly medium difficulty. The easier way is to use xop and the tougher way is to use flags. Each has their own benefits and drawbacks aside from ease of use. This method depends heavily on the use of levels. It is recommended you read that article first or together with this one in a separate window before continuing. Described below are the various sub commands that can be used with access and example uses for each one.
This one adds a new entry to your list. This command must have 2 arguments, the mask to add (usually a nickname) and an access level to set. To add nick1 to the access list of #channel as being automatically voiced upon joining a channel, you can use this command:
/msg ChanServ access #channel add nick1 autovoice
It is generally considered that this is the toughest aspect of using the access command for channel access management.
This removes access entries to your list. If a nickname is specified, only that nickname is removed, if present. You can also specify a range of entries to delete or specific numbered entries be removed. If looking to clear out multiple entries, use the list sub command described below to see which numbers you wish to remove. If you wish to completely remove the access list except for the founder, use the clear command below. Only the channel founder is allowed to do this. This command accepts 1 argument, the access entry or entries to delete. To delete entries 3, 5, 6, and 7 from your list, you can run the following command. Note the lack of spaces between numbered entries.
/msg ChanServ access #channel del 3,5-7
Note that you can always remove yourself from an access list regardless of what your access is, unless your access level is akick.
This command lists all of your access list entries for the provided channel. You can use this to search the access list by host mask or nickname while using wild cards. It accepts 0 or 1 argument, the mask to search for. To list all of the access entries for #channel that contain "bot" in the host mask or nickname, use the following command:
/msg ChanServ access #channel list *bot*
This command is identical to the above, but takes 0 arguments and instead always shows the entire access list. It also provides who added the access entry and when that user last joined the channel. You can run the command for #channel as follows:
/msg ChanServ access #channel view
This command is the most dangerous one. It completely resets the channel access list to whatever values it had during registration. This means only the founder will be recognized. As such, only the channel founder may run this command. Note that once you wipe a channel's access list clean, there is no way to recover it. To completely clear out the access list on #channel, you would use the following command:
/msg ChanServ access #channel clear