PROP (new IRCX command)
Prev Chapter 3. IRCX Client Messages Next

PROP (new IRCX command)

Add, change or delete a channel data property.

Syntax 1 (query a property): 

PROP <channel> <property>[,<property>]

Syntax 2 (set or change a property): 

PROP <channel> <property> :<data>

Syntax 3 (delete a property): 

PROP <channel> <property> :

Results

PROP message
IRCRPL_PROPLIST
IRCRPL_PROPEND

Possible Errors

IRCERR_BADCOMMAND
IRCERR_BADPROPERTY
IRCERR_SECURITY
IRCERR_NOSUCHOBJECT
IRCERR_TOOMANYARGUMENTS
IRCERR_BADVALUE

Remarks

The PROP command provides a new method for manipulating string and numeric properties of channels. If an optional channel property is not supported on the server, the server should return IRCERR_BADPROPERTY.

See later sections for definitions of channel properties.

Examples

Example 3.15. Check two properties

Client: PROP #MyChan TOPIC,ONJOIN
Server: :<server> 818 <nick> #MyChan TOPIC :This is the topic of my channel
Server: :<server> 818 <nick> #MyChan ONJOIN :Welcome to my channel!
Server: :<server> 819 <nick> #MyChan :End of properties

Example 3.16. Change the TOPIC property

Client: PROP #MyChannel TOPIC :Change my channel topic
Server: :User!Ident@Host PROP #MyChannel TOPIC :Change my channel topic

[Note]Editor's Note

The second example was changed in order to clarify that the client who set the property should have his/her prefix at the beginning of the response.

Prev Up Next
PRIVMSG (extension to RFC1459 command) Home WHISPER (new IRCX command)