usermodes.yaml

# usermodes.yaml
#
# This file is Copyright (c) 2015-2019 Daniel Oaks
#  <daniel@danieloaks.net>
# This file is Copyright (c) 2001-2004 Simon Butcher
#  <pickle@alien.net.au>
#
# This file is PUBLIC DOMAIN, to benefit the IRC developer community. If you
# modify this file, please state your name and modifications here in order
# for people to be able to distinguish between your version and this version.
#
# For more information or corrections, please contact the author.

file:
    type: "usermodes"
    revision: "1.20"

# The following information is used to create pretty HTML page and tables

page:
    name: User Modes
    extra: >
        <p>
            Red denotes a conflicting numeric definition, gray for deprecated
            (however quite possibly still in use), and blue for OK.
        </p>

table:
    row-ids:
        - char
        - name

    row-classes:
        - conflict
        - obsolete

    columns:
        -
            name: Mode
            content: char
            classes: code center
            inline-links:
                - char
                - name
            description: Mode character
        -
            name: Name
            content: name
            classes: code
            link: information
        -
            name: Origin
            content: origin
            link: contact
            description: Where the prefix came from
        -
            name: Server On
            content: server_on
            description: "Only a server can set this mode"
            classes: center
        -
            name: Server Off
            content: server_off
            description: "Only a server can unset this mode"
            classes: center
        -
            name: Parameter
            content: parameter
            classes: code
            description: Parameter for the mode
        -
            name: Comments
            content: comment
            seealso: seealso
            description: "Additional comments, history and other details"

# The following format is used through-out this file. The first two fields
# ('irc2char' and 'name') are mandatory, the others may or may not exist.

format:
    char: mode char for irc protocol(s)
    name: mode name
    origin: where the mode was found
    when: release version or announced date
    contact: point of contact associated with the mode
    information: url where to find more information
    parameter: parameter name
    comment: "comments, history etc"
    server_on: true
    server_off: true
    conflict: true
    obsolete: true

values:
    -
        char: a
        name: AWAY
        origin: RFC2812
        comment: User is away (see AWAY command?)
        server_on: Y
        server_off: Y
        conflict: true

    -
        char: a
        name: SERVICES_ADMIN
        origin: "Bahamut, Unreal"
        comment: User is a services administrator
        conflict: true

    -
        char: a
        name: ADMIN
        origin: Hybrid
        comment: >
            Admin status. Shown as an admin in WHOIS, able to load and
            unload modules, and see IP's in STATS c

        conflict: true

    -
        char: a
        name: ERRORS
        origin: AustHex
        comment: User receives all errors and alerts
        conflict: true

    -
        char: A
        name: SERVER_ADMIN
        origin: "Bahamut, Unreal"
        comment: User is a server administrator

    -
        char: b
        name: BOTS
        origin: Hybrid
        comment: User receives information about potential bots/drones
        conflict: true

    -
        char: b
        name: CHATOPS
        origin: "Bahamut, Unreal"
        comment: User receives CHATOPS messages
        conflict: true

    -
        char: B
        name: BOT
        origin: Unreal
        comment: User is a bot/drone

    -
        char: c
        name: CLIENT_CONNS
        origin: Hybrid
        comment: >
            User receives information about clients connecting/disconnecting

        conflict: true

    -
        char: c
        name: COMMON_CHANS
        origin: InspIRCd
        comment: >
            Other users must be in a common channel before being able to
            PRIVMSG this user.

        conflict: true

    -
        char: C
        name: CO_ADMIN
        origin: Unreal
        comment: User is a co-administrator

    -
        char: d
        name: DEAF
        origin: ircu
        comment: User does not receive channel messages
        conflict: true

    -
        char: d
        name: DEAF
        comment: >
            User does not receive channel messages unless they are prefixed
            with a specific character (usually '!' ?). This is an extension
            of the ircu '+d'

        conflict: true

    -
        char: d
        name: DEBUG
        origin: "Hybrid, Bahamut"
        comment: User receives debugging messages
        conflict: true

    -
        char: D
        name: DEAF
        origin: Hybrid?

    -
        char: e
        name: EXTERNAL
        origin: Hybrid?
        comment: >
            User receives information about servers connecting/disconnecting

    -
        char: f
        name: FULL
        origin: Hybrid
        comment: >
            User receives notices about I-lines being full, or too many
            clients in general

        conflict: true

    -
        char: f
        name: FLOODS
        origin: Bahamut
        comment: User receives flood notices
        conflict: true

    -
        char: F
        name: REMOTE_CLIENT_CONNS
        origin: Hybrid?
        comment: >
            User receives information about remote clients
            connecting/disconnecting

    -
        char: g
        name: DEBUG
        origin: ircu
        comment: User receives debugging messages
        conflict: true

    -
        char: g
        name: CALLERID
        origin: Hybrid
        comment: >
            User is ignoring everyone, unless they are ACCEPTed with the
            ACCEPT command

        conflict: true

    -
        char: g
        name: GLOBOPS
        origin: Bahamut
        comment: User receives GLOBOPS messages
        conflict: true

    -
        char: G
        name: CENSOR
        origin: InspIRCd
        comment: Censors messages based on the network config file.
        conflict: true

    -
        char: G
        name: STRIP_BAD_WORDS
        origin: Unreal
        comment: Messages user receives are stripped of profanity
        conflict: true

    -
        char: G
        name: SOFTCALLERID
        origin: Hybrid
        comment: >
            User is ignoring everyone they are not on common channels
            with, unless they are ACCEPTed with the ACCEPT command

        conflict: true

    -
        char: h
        name: HELPER
        origin: "Bahamut, AustHex"
        comment: "User is a HELPER, associated with network services"
        server_on: Y
        conflict: true

    -
        char: h
        name: HELPOP
        origin: ircd-seven
        comment: >
            User has marked themselves available for help, listed in the output
            of /stats p
        conflict: true

    -
        char: H
        name: HIDE_OPER
        origin: Unreal
        comment: Hides oper status from users (i.e. whois)

    -
        char: i
        name: INVISIBLE
        origin: RFC1459
        comment: User is invisible

    -
        char: I
        name: HIDECHANS
        origin: InspIRCd
        comment: Hides all channels the user's in from WHOIS.

    -
        char: I
        name: INVISIBLE_JOINPART
        origin: Unreal
        comment: >
            User is invisible when joining/parting channels. This is
            obsolete as of UnrealIRCd 3.2 beta 16

        obsolete: true
        conflict: true

    -
        char: j
        name: REJ
        origin: Hybrid?
        comment: User receives notices about rejected clients

    -
        char: k
        name: SERVICE
        origin: ircu
        comment: >
            User is a service (cannot be KILLed or KICKed from channels, and
            WHOIS output is usually limited)

        conflict: true

    -
        char: k
        name: KILLS
        origin: "Hybrid, Bahamut"
        comment: User receives KILL notices
        conflict: true

    -
        char: l
        name: LOCOPS
        origin: Hybrid
        comment: User receives LOCOPS messages
        conflict: true

    -
        char: l
        name: LISTALL
        origin: AustHex
        comment: User can list all channels (including hidden ones)
        conflict: true

    -
        char: n
        name: NCHANGE
        origin: Hybrid
        comment: User sees client nick changes
        conflict: true

    -
        char: n
        name: ROUTING
        origin: Bahamut
        comment: User receives routing messages
        conflict: true

    -
        char: N
        name: NETWORK_ADMIN
        origin: Unreal
        comment: User is a network administrator

    -
        char: m
        name: SPAMBOTS
        origin: Bahamut
        comment: User receives notices about (potential) spambots

    -
        char: o
        name: GLOBAL_OPERATOR
        origin: RFC1459
        comment: User is a network-wide or 'global' operator

    -
        char: O
        name: LOCAL_OPERATOR
        origin: RFC2812
        comment: User is a server-wide or 'local' operator

    -
        char: O
        name: HELPER
        origin: ircd-seven
        comment: >
            User is an operator with limited powers, can only set umode +h and
            receive operwalls

    -
        char: p
        name: HIDE_CHANNELS
        origin: Unreal
        comment: >
            Hide channels from user's WHOIS reply (will suppress
            RPL_WHOISCHANNELS)

    -
        char: p
        name: OVERRIDE
        origin: Charybdis
        comment: >
            User can send to, join, and execute commands on channels regardless
            of any modes that would normally prevent them from doing so.

    -
        char: q
        name: KIX
        origin: Unreal
        comment: "Only U:liners/arbiters can kick this user"
        conflict: true

    -
        char: q
        name: QUIET
        origin: Hybrid?
        comment: "Hides idle and signon time from user's WHOIS reply"
        conflict: true

    -
        char: r
        name: RESTRICTED
        origin: RFC2812
        comment: Restricted user connection
        server_on: Y
        server_off: Y
        conflict: true

    -
        char: r
        name: REGISTERED
        origin: "Bahamut, ircu"
        comment: Nickname is registered with a network nickname service
        server_on: Y
        server_off: Y
        conflict: true

    -
        char: r
        name: REJ
        origin: Hybrid
        comment: User receives notices about rejected clients
        conflict: true
        obsolete: true

    -
        char: R
        name: NO_NON_REGISTERED
        origin: "Bahamut, Unreal"
        server_on: Y
        server_off: Y
        comment: User wants to block messages from non-registered nicknames

    -
        char: s
        name: SERVER_NOTICES
        origin: RFC1459
        comment: >
            User receives server notices. RFC2812 considers this mode
            obsolete, however it is still in very wide-spread use.

    -
        char: s
        name: SERVER_NOTICES
        origin: ircu
        parameter: Mask integer
        comment: >
            User receives server notices, and can opt in/out of particular
            notice types by supplying the optional mask as an integer

    -
        char: s
        name: SERVER_NOTICES
        origin: "Unreal"
        parameter: Notice mask list
        comment: >
            User receives server notices. The notice masks are normally a
            list of letters corresponding with specific notices the user
            wishes to receive, such as 'D' for debugging, etc.

    -
        char: S
        name: SERVICE
        origin: Unreal
        comment: "User is a service, and is protected."
        conflict: true

    -
        char: S
        name: SSL
        origin: Hybrid?
        comment: >
            User is connected via SSL/TLS. See also +Z SSLCLIENT
            and +z SECURE.
        server_on: Y
        server_off: Y
        conflict: true

    -
        char: S
        name: STRIPCOLOR
        origin: InspIRCd
        comment: Strips control codes from messages to the user
        conflict: true

    -
        char: t
        name: Z_LINED
        origin: AustHex
        comment: "User is using an AustHex Z: line"
        server_on: Y
        server_off: Y
        conflict: true

    -
        char: t
        name: MODIFIED_HOST
        origin: Unreal
        comment: User is using a /vhost (modified host)
        server_on: Y
        server_off: Y
        conflict: true

    -
        char: T
        name: W_LINED
        origin: AustHex
        comment: "User is using an AustHex w: line"
        server_on: Y
        server_off: Y
        conflict: true

    -
        char: T
        name: BLOCK_CTCP
        origin: Unreal
        comment: Blocks all CTCP requests from other users
        conflict: true

    -
        char: u
        name: UNAUTH
        origin: Hybrid
        comment: User receives unauthorized client connection notices

    -
        char: v
        name: HOST_HIDING
        origin: AustHex
        comment: >
            Hide the host of the user, often with a hashed value. Some
            networks use 'mirroring', or masking with metacharacters. The
            letter 'v' comes from Austnet's 'Virtual World'. Be aware that
            use of +x for the same purpose is more wide-spread.

        conflict: true

    -
        char: v
        name: VICTIM
        origin: Unreal
        comment: User receives messages regarding infected DCC rejections
        conflict: true

    -
        char: V
        name: WEBTV
        origin: Unreal
        comment: User is using a WebTV client

    -
        char: w
        name: WALLOPS
        origin: RFC1459
        comment: User receives WALLOPS messages

    -
        char: W
        name: WHOIS_PARANOIA
        origin: Unreal
        comment: User is receives a notice when WHOIS'd
        conflict: true

    -
        char: W
        name: WEBIRC
        origin: Hybrid?
        comment: Designates this user is connected using a webirc gateway
        conflict: true

    -
        char: x
        name: HOST_HIDING
        origin: "ircu, Unreal"
        comment: >
            Hide the host of the user, often with a hashed value. Some
            networks use 'mirroring', or masking with metacharacters. Using
            the 'x' letter for this mode appears to be the most standard
            method for toggling masking user hosts.

    -
        char: x
        name: EXTERNAL
        origin: Hybrid
        comment: >
            User receives notices about servers connecting/disconnecting.
            Hybrid now uses the 'e' character for this mode

        conflict: true
        obsolete: true

    -
        char: y
        name: STATS_LINKS
        origin: Bahamut
        comment: User receives notices about stats/links
        conflict: true

    -
        char: y
        name: SPY
        origin: Hybrid
        comment: >
            User receives LINKS, STATS (if configured) and TRACE notices

        conflict: true

    -
        char: z
        name: OPERWALL
        origin: Hybrid
        comment: User receives operator generated WALLOPS messages
        conflict: true

    -
        char: z
        name: SECURE
        origin: Unreal
        comment: >
            User is connected via SSL/TLS. See also +Z SSLCLIENT and
            +S SSL.
        conflict: true

    -
        char: z
        name: SSLQUERIES
        origin: InspIRCd
        comment: >
            Prevents messages from being sent to or received from a
            user that is not connected using SSL/TLS. See also
            +Z SECURED_ONLY.
        conflict: true

    -
        char: Z
        name: SECURED_ONLY
        origin: Unreal
        comment: >
            Prevents messages from being sent to or received from a
            user that is not connected using SSL/TLS. See also
            +z SSLQUERIES.
        conflict: true

    -
        char: Z
        name: SSLCLIENT
        origin: Charybdis
        comment: >
            User is connected via SSL/TLS. See also +z SECURE and
            +S SSL.
        conflict: true