ircu api - privileges - Revision history

Admin at 15:24, 17 February 2009

2009-02-17T15:24:13Z

← Older revision		Revision as of 15:24, 17 February 2009
Line 91:		Line 91:
	</changelog></pre>		</changelog></pre>

-	~~== List of PRIV FLAGS ==~~
-
-	~~NOTE: If you are using OperServ's PRIVSET command, drop PRIV_ from the flag. For example, if you wanted to grant the PRIV_CHECK privilege, you would specify just CHECK as the flag.~~
-
-	* '''PRIV_CHAN_LIMIT''' - no channel limit on oper
-	* '''PRIV_MODE_LCHAN''' - oper can mode local chans
-	* '''PRIV_WALK_LCHAN''' - oper can walk through local modes
-	* '''PRIV_DEOP_LCHAN''' - no deop oper on local chans
-	* '''PRIV_SHOW_INVIS''' - show local invisible users
-	* '''PRIV_SHOW_ALL_INVIS''' - show all invisible users
-	* '''PRIV_UNLIMIT_QUERY''' - unlimit who queries
-	* '''PRIV_KILL''' - oper can KILL
-	* '''PRIV_LOCAL_KILL''' - oper can local KILL
-	* '''PRIV_REHASH''' - oper can REHASH
-	* '''PRIV_RESTART''' - oper can RESTART
-	* '''PRIV_DIE''' - oper can DIE
-	* '''PRIV_GLINE''' - oper can GLINE
-	* '''PRIV_LOCAL_GLINE''' - oper can local GLINE
-	* '''PRIV_ZLINE''' - oper can ZLINE
-	* '''PRIV_LOCAL_ZLINE''' - oper can local ZLINE
-	* '''PRIV_SHUN''' - oper can SHUN
-	* '''PRIV_LOCAL_SHUN''' - oper can local SHUN
-	* '''PRIV_JUPE''' - oper can JUPE
-	* '''PRIV_LOCAL_JUPE''' - oper can local JUPE
-	* '''PRIV_OPMODE''' - oper can OP/CLEARMODE
-	* '''PRIV_LOCAL_OPMODE''' - oper can local OP/CLEARMODE
-	* '''PRIV_SET''' - oper can SET
-	* '''PRIV_WHOX''' - oper can use /who x
-	* '''PRIV_BADCHAN''' - oper can BADCHAN
-	* '''PRIV_LOCAL_BADCHAN''' - oper can local BADCHAN
-	* '''PRIV_SEE_CHAN''' - oper can see in secret chans
-	* '''PRIV_PROPAGATE''' - propagate oper status
-	* '''PRIV_DISPLAY''' - "Is an oper" displayed
-	* '''PRIV_SEE_OPERS''' - display hidden opers
-	* '''PRIV_WIDE_GLINE''' - oper can set wider G-lines
-	* '''PRIV_WIDE_ZLINE''' - oper can set wider Z-lines
-	* '''PRIV_WIDE_SHUN''' - oper can set wider Shuns
-	* '''PRIV_LIST_CHAN''' - oper can list secret channels
-	* '''PRIV_FORCE_OPMODE''' - can hack modes on quarantined channels
-	* '''PRIV_FORCE_LOCAL_OPMODE''' - can hack modes on quarantined local channels
-	* '''PRIV_CHECK''' - oper can use CHECK
-	* '''PRIV_SEE_SECRET_CHAN''' - oper can see +s channels in whois
-	* '''PRIV_LAST_PRIV''' - number of privileges

	[[Category:IRCu API\|Privileges]]		[[Category:IRCu API\|Privileges]]

Secretagent: /* List of PRIV FLAGS */ grammar

2008-07-16T18:35:46Z

List of PRIV FLAGS: grammar

← Older revision		Revision as of 18:35, 16 July 2008
Line 93:		Line 93:
	== List of PRIV FLAGS ==		== List of PRIV FLAGS ==

-	NOTE: If you are using OperServ's PRIVSET ~~flag~~, drop PRIV_ from the flag. For example, if you wanted to grant the PRIV_CHECK privilege, you would specify just CHECK as the flag.	+	NOTE: If you are using OperServ's PRIVSET command, drop PRIV_ from the flag. For example, if you wanted to grant the PRIV_CHECK privilege, you would specify just CHECK as the flag.

	* '''PRIV_CHAN_LIMIT''' - no channel limit on oper		* '''PRIV_CHAN_LIMIT''' - no channel limit on oper

Secretagent: /* List of PRIV FLAGS */

2008-07-16T18:35:23Z

List of PRIV FLAGS

← Older revision		Revision as of 18:35, 16 July 2008
Line 92:		Line 92:

	== List of PRIV FLAGS ==		== List of PRIV FLAGS ==
		+
		+	NOTE: If you are using OperServ's PRIVSET flag, drop PRIV_ from the flag. For example, if you wanted to grant the PRIV_CHECK privilege, you would specify just CHECK as the flag.

	* '''PRIV_CHAN_LIMIT''' - no channel limit on oper		* '''PRIV_CHAN_LIMIT''' - no channel limit on oper

Secretagent: /* List of PRIV FLAGS */

2008-07-16T18:33:05Z

List of PRIV FLAGS

← Older revision		Revision as of 18:33, 16 July 2008
Line 93:		Line 93:
	== List of PRIV FLAGS ==		== List of PRIV FLAGS ==

-	* PRIV_CHAN_LIMIT - no channel limit on oper	+	* '''PRIV_CHAN_LIMIT''' - no channel limit on oper
-	* PRIV_MODE_LCHAN - oper can mode local chans	+	* '''PRIV_MODE_LCHAN''' - oper can mode local chans
-	* PRIV_WALK_LCHAN - oper can walk through local modes	+	* '''PRIV_WALK_LCHAN''' - oper can walk through local modes
-	* PRIV_DEOP_LCHAN - no deop oper on local chans	+	* '''PRIV_DEOP_LCHAN''' - no deop oper on local chans
-	* PRIV_SHOW_INVIS - show local invisible users	+	* '''PRIV_SHOW_INVIS''' - show local invisible users
-	* PRIV_SHOW_ALL_INVIS - show all invisible users	+	* '''PRIV_SHOW_ALL_INVIS''' - show all invisible users
-	* PRIV_UNLIMIT_QUERY - unlimit who queries	+	* '''PRIV_UNLIMIT_QUERY''' - unlimit who queries
-	* PRIV_KILL - oper can KILL	+	* '''PRIV_KILL''' - oper can KILL
-	* PRIV_LOCAL_KILL - oper can local KILL	+	* '''PRIV_LOCAL_KILL''' - oper can local KILL
-	* PRIV_REHASH - oper can REHASH	+	* '''PRIV_REHASH''' - oper can REHASH
-	* PRIV_RESTART - oper can RESTART	+	* '''PRIV_RESTART''' - oper can RESTART
-	* PRIV_DIE - oper can DIE	+	* '''PRIV_DIE''' - oper can DIE
-	* PRIV_GLINE - oper can GLINE	+	* '''PRIV_GLINE''' - oper can GLINE
-	* PRIV_LOCAL_GLINE - oper can local GLINE	+	* '''PRIV_LOCAL_GLINE''' - oper can local GLINE
-	* PRIV_ZLINE - oper can ZLINE	+	* '''PRIV_ZLINE''' - oper can ZLINE
-	* PRIV_LOCAL_ZLINE - oper can local ZLINE	+	* '''PRIV_LOCAL_ZLINE''' - oper can local ZLINE
-	* PRIV_SHUN - oper can SHUN	+	* '''PRIV_SHUN''' - oper can SHUN
-	* PRIV_LOCAL_SHUN - oper can local SHUN	+	* '''PRIV_LOCAL_SHUN''' - oper can local SHUN
-	* PRIV_JUPE - oper can JUPE	+	* '''PRIV_JUPE''' - oper can JUPE
-	* PRIV_LOCAL_JUPE - oper can local JUPE	+	* '''PRIV_LOCAL_JUPE''' - oper can local JUPE
-	* PRIV_OPMODE - oper can OP/CLEARMODE	+	* '''PRIV_OPMODE''' - oper can OP/CLEARMODE
-	* PRIV_LOCAL_OPMODE - oper can local OP/CLEARMODE	+	* '''PRIV_LOCAL_OPMODE''' - oper can local OP/CLEARMODE
-	* PRIV_SET - oper can SET	+	* '''PRIV_SET''' - oper can SET
-	* PRIV_WHOX - oper can use /who x	+	* '''PRIV_WHOX''' - oper can use /who x
-	* PRIV_BADCHAN - oper can BADCHAN	+	* '''PRIV_BADCHAN''' - oper can BADCHAN
-	* PRIV_LOCAL_BADCHAN - oper can local BADCHAN	+	* '''PRIV_LOCAL_BADCHAN''' - oper can local BADCHAN
-	* PRIV_SEE_CHAN - oper can see in secret chans	+	* '''PRIV_SEE_CHAN''' - oper can see in secret chans
-	* PRIV_PROPAGATE - propagate oper status	+	* '''PRIV_PROPAGATE''' - propagate oper status
-	* PRIV_DISPLAY - "Is an oper" displayed	+	* '''PRIV_DISPLAY''' - "Is an oper" displayed
-	* PRIV_SEE_OPERS - display hidden opers	+	* '''PRIV_SEE_OPERS''' - display hidden opers
-	* PRIV_WIDE_GLINE - oper can set wider G-lines	+	* '''PRIV_WIDE_GLINE''' - oper can set wider G-lines
-	* PRIV_WIDE_ZLINE - oper can set wider Z-lines	+	* '''PRIV_WIDE_ZLINE''' - oper can set wider Z-lines
-	* PRIV_WIDE_SHUN - oper can set wider Shuns	+	* '''PRIV_WIDE_SHUN''' - oper can set wider Shuns
-	* PRIV_LIST_CHAN - oper can list secret channels	+	* '''PRIV_LIST_CHAN''' - oper can list secret channels
-	* PRIV_FORCE_OPMODE - can hack modes on quarantined channels	+	* '''PRIV_FORCE_OPMODE''' - can hack modes on quarantined channels
-	* PRIV_FORCE_LOCAL_OPMODE - can hack modes on quarantined local channels	+	* '''PRIV_FORCE_LOCAL_OPMODE''' - can hack modes on quarantined local channels
-	* PRIV_CHECK - oper can use CHECK	+	* '''PRIV_CHECK''' - oper can use CHECK
-	* PRIV_SEE_SECRET_CHAN - oper can see +s channels in whois	+	* '''PRIV_SEE_SECRET_CHAN''' - oper can see +s channels in whois
-	* PRIV_LAST_PRIV - number of privileges	+	* '''PRIV_LAST_PRIV''' - number of privileges

	[[Category:IRCu API\|Privileges]]		[[Category:IRCu API\|Privileges]]

Secretagent at 18:30, 16 July 2008

2008-07-16T18:30:25Z

← Older revision		Revision as of 18:30, 16 July 2008
Line 90:		Line 90:
	[2001-6-15 Kev] Initial documentation of the privileges system.		[2001-6-15 Kev] Initial documentation of the privileges system.
	</changelog></pre>		</changelog></pre>
		+
		+	== List of PRIV FLAGS ==
		+
		+	* PRIV_CHAN_LIMIT - no channel limit on oper
		+	* PRIV_MODE_LCHAN - oper can mode local chans
		+	* PRIV_WALK_LCHAN - oper can walk through local modes
		+	* PRIV_DEOP_LCHAN - no deop oper on local chans
		+	* PRIV_SHOW_INVIS - show local invisible users
		+	* PRIV_SHOW_ALL_INVIS - show all invisible users
		+	* PRIV_UNLIMIT_QUERY - unlimit who queries
		+	* PRIV_KILL - oper can KILL
		+	* PRIV_LOCAL_KILL - oper can local KILL
		+	* PRIV_REHASH - oper can REHASH
		+	* PRIV_RESTART - oper can RESTART
		+	* PRIV_DIE - oper can DIE
		+	* PRIV_GLINE - oper can GLINE
		+	* PRIV_LOCAL_GLINE - oper can local GLINE
		+	* PRIV_ZLINE - oper can ZLINE
		+	* PRIV_LOCAL_ZLINE - oper can local ZLINE
		+	* PRIV_SHUN - oper can SHUN
		+	* PRIV_LOCAL_SHUN - oper can local SHUN
		+	* PRIV_JUPE - oper can JUPE
		+	* PRIV_LOCAL_JUPE - oper can local JUPE
		+	* PRIV_OPMODE - oper can OP/CLEARMODE
		+	* PRIV_LOCAL_OPMODE - oper can local OP/CLEARMODE
		+	* PRIV_SET - oper can SET
		+	* PRIV_WHOX - oper can use /who x
		+	* PRIV_BADCHAN - oper can BADCHAN
		+	* PRIV_LOCAL_BADCHAN - oper can local BADCHAN
		+	* PRIV_SEE_CHAN - oper can see in secret chans
		+	* PRIV_PROPAGATE - propagate oper status
		+	* PRIV_DISPLAY - "Is an oper" displayed
		+	* PRIV_SEE_OPERS - display hidden opers
		+	* PRIV_WIDE_GLINE - oper can set wider G-lines
		+	* PRIV_WIDE_ZLINE - oper can set wider Z-lines
		+	* PRIV_WIDE_SHUN - oper can set wider Shuns
		+	* PRIV_LIST_CHAN - oper can list secret channels
		+	* PRIV_FORCE_OPMODE - can hack modes on quarantined channels
		+	* PRIV_FORCE_LOCAL_OPMODE - can hack modes on quarantined local channels
		+	* PRIV_CHECK - oper can use CHECK
		+	* PRIV_SEE_SECRET_CHAN - oper can see +s channels in whois
		+	* PRIV_LAST_PRIV - number of privileges

	[[Category:IRCu API\|Privileges]]		[[Category:IRCu API\|Privileges]]

Secretagent: New page:

Access control becomes more of a problem as you have more and more users that need to access certain features.  As it stands, ircu has only 3 access levels: ordinary user, local opera...

2008-04-25T04:07:24Z

New page: <pre>Access control becomes more of a problem as you have more and more users that need to access certain features. As it stands, ircu has only 3 access levels: ordinary user, local opera...

New page

<pre>Access control becomes more of a problem as you have more and more
users that need to access certain features. As it stands, ircu has
only 3 access levels: ordinary user, local operator, and global
operator. This is hardly enough control, especially over some of the
more advanced and powerful features, such as G-lines.

Since u2.10.11, ircu includes the concept of privileges. Privileges
are basically an arbitrarily long bit string. Access to particular
features is governed by the value of a particular bit of that bit
string--in other words, privileges are a form of Access Control List.
This document covers the basic structures and macros used by the
privileges system.

<struct>
struct Privs;

The Privs structure stores a privileges bit string and represents a
user's entire privilege set. This is implemented as a structure,
rather than as an array of integers, in order to leverage C's
structure copy.
</struct>

<function>
void PrivSet(struct Privs pset, int priv);

This macro sets the privilege specified by _priv_ in the privileges
structure. This macro evaluates the _priv_ argument twice.
</function>

<function>
void PrivClr(struct Privs pset, int priv);

This macro clears the privilege specified by _priv_ in the privileges
structure. This macro evaluates the _priv_ argument twice.
</function>

<function>
int PrivHas(struct Privs pset, int priv);

This macro tests whether the privilege specified by _priv_ is set in
the privileges structure, returning non-zero if it is. This macro
evaluates the _priv_ argument twice.
</function>

<function>
void GrantPriv(struct Client* cli, int priv);

This macro grants a particular client, specified by _cli_, the
privilege specified by _priv_. This macro evaluates the _priv_
argument twice.
</function>

<function>
void RevokePriv(struct Client* cli, int priv);

This macro revokes the privilege specified by _priv_ from the client.
This macro evaluates the _priv_ argument twice.
</function>

<function>
int HasPriv(struct Client* cli, int priv);

This macro tests whether the client specified by _cli_ has the
privilege specified by _priv_, returning non-zero if so. This macro
evaluates the _priv_ argument twice.
</function>

<function>
void client_set_privs(struct Client* client);

The ircu configuration file does not yet support privileges. This
function thus sets the appropriate privileges for an operator, based
upon various feature settings. It should be called whenever there is
a change in a user's IRC operator status.
</function>

<function>
int client_report_privs(struct Client *to, struct Client *client);

This function sends the client specified by _to_ a list of the
privileges that another client has. It returns a value of 0 for the
convenience of other functions that must return an integer value.
</function>

<authors>
Kev <klmitch@mit.edu>
</authors>

<changelog>
[2001-6-15 Kev] Initial documentation of the privileges system.
</changelog></pre>

[[Category:IRCu API|Privileges]]