/* * command.c * * Copyright (C) 2012 - 2015 James Booth * * This file is part of Profanity. * * Profanity is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Profanity is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with Profanity. If not, see . * * In addition, as a special exception, the copyright holders give permission to * link the code of portions of this program with the OpenSSL library under * certain conditions as described in each individual source file, and * distribute linked combinations including the two. * * You must obey the GNU General Public License in all respects for all of the * code used other than OpenSSL. If you modify file(s) with this exception, you * may extend this exception to your version of the file(s), but you are not * obligated to do so. If you do not wish to do so, delete this exception * statement from your version. If you delete this exception statement from all * source files in the program, then also delete it here. * */ #include "config.h" #include #include #include #include #include #include #include #include "chat_session.h" #include "command/command.h" #include "command/commands.h" #include "common.h" #include "config/accounts.h" #include "config/preferences.h" #include "config/theme.h" #include "config/tlscerts.h" #include "config/scripts.h" #include "contact.h" #include "roster_list.h" #include "jid.h" #include "xmpp/form.h" #include "log.h" #include "muc.h" #ifdef HAVE_LIBOTR #include "otr/otr.h" #endif #ifdef HAVE_LIBGPGME #include "pgp/gpg.h" #endif #include "profanity.h" #include "tools/autocomplete.h" #include "tools/parser.h" #include "tools/tinyurl.h" #include "xmpp/xmpp.h" #include "xmpp/bookmark.h" #include "ui/ui.h" #include "window_list.h" static gboolean _cmd_execute(ProfWin *window, const char *const command, const char *const inp); static char* _cmd_complete_parameters(ProfWin *window, const char *const input); static char* _sub_autocomplete(ProfWin *window, const char *const input); static char* _notify_autocomplete(ProfWin *window, const char *const input); static char* _theme_autocomplete(ProfWin *window, const char *const input); static char* _autoaway_autocomplete(ProfWin *window, const char *const input); static char* _autoconnect_autocomplete(ProfWin *window, const char *const input); static char* _account_autocomplete(ProfWin *window, const char *const input); static char* _who_autocomplete(ProfWin *window, const char *const input); static char* _roster_autocomplete(ProfWin *window, const char *const input); static char* _group_autocomplete(ProfWin *window, const char *const input); static char* _bookmark_autocomplete(ProfWin *window, const char *const input); static char* _otr_autocomplete(ProfWin *window, const char *const input); static char* _pgp_autocomplete(ProfWin *window, const char *const input); static char* _connect_autocomplete(ProfWin *window, const char *const input); static char* _statuses_autocomplete(ProfWin *window, const char *const input); static char* _alias_autocomplete(ProfWin *window, const char *const input); static char* _join_autocomplete(ProfWin *window, const char *const input); static char* _log_autocomplete(ProfWin *window, const char *const input); static char* _form_autocomplete(ProfWin *window, const char *const input); static char* _form_field_autocomplete(ProfWin *window, const char *const input); static char* _occupants_autocomplete(ProfWin *window, const char *const input); static char* _kick_autocomplete(ProfWin *window, const char *const input); static char* _ban_autocomplete(ProfWin *window, const char *const input); static char* _affiliation_autocomplete(ProfWin *window, const char *const input); static char* _role_autocomplete(ProfWin *window, const char *const input); static char* _resource_autocomplete(ProfWin *window, const char *const input); static char* _titlebar_autocomplete(ProfWin *window, const char *const input); static char* _inpblock_autocomplete(ProfWin *window, const char *const input); static char* _time_autocomplete(ProfWin *window, const char *const input); static char* _receipts_autocomplete(ProfWin *window, const char *const input); static char* _help_autocomplete(ProfWin *window, const char *const input); static char* _wins_autocomplete(ProfWin *window, const char *const input); static char* _tls_autocomplete(ProfWin *window, const char *const input); static char* _script_autocomplete(ProfWin *window, const char *const input); static char* _subject_autocomplete(ProfWin *window, const char *const input); GHashTable *commands = NULL; #define CMD_TAG_CHAT "chat" #define CMD_TAG_GROUPCHAT "groupchat" #define CMD_TAG_ROSTER "roster" #define CMD_TAG_PRESENCE "presence" #define CMD_TAG_CONNECTION "connection" #define CMD_TAG_DISCOVERY "discovery" #define CMD_TAG_UI "ui" #define CMD_NOTAGS { { NULL }, #define CMD_TAGS(...) { { __VA_ARGS__, NULL }, #define CMD_SYN(...) { __VA_ARGS__, NULL }, #define CMD_DESC(desc) desc, #define CMD_NOARGS { { NULL, NULL } }, #define CMD_ARGS(...) { __VA_ARGS__, { NULL, NULL } }, #define CMD_NOEXAMPLES { NULL } } #define CMD_EXAMPLES(...) { __VA_ARGS__, NULL } } /* * Command list */ static struct cmd_t command_defs[] = { { "/help", cmd_help, parse_args, 0, 2, NULL, CMD_NOTAGS CMD_SYN( "/help [|]") CMD_DESC( "Help on using Profanity. Passing no arguments list help areas. " "For command help, optional arguments are shown using square brackets e.g. [argument], " "arguments representing variables rather than a literal name are surrounded by angle brackets " "e.g. . " "Arguments that may be one of a number of values are separated by a pipe " "e.g. val1|val2|val3.") CMD_ARGS( { "", "Summary help for commands in a certain area of functionality." }, { "", "Full help for a specific command, for example '/help connect'." }) CMD_EXAMPLES( "/help commands", "/help presence", "/help who") }, { "/about", cmd_about, parse_args, 0, 0, NULL, CMD_NOTAGS CMD_SYN( "/about") CMD_DESC( "Show version and license information.") CMD_NOARGS CMD_NOEXAMPLES }, { "/connect", cmd_connect, parse_args, 0, 7, NULL, CMD_TAGS( CMD_TAG_CONNECTION) CMD_SYN( "/connect []", "/connect [server ] [port ] [tls force|allow|disable]") CMD_DESC( "Login to a chat service. " "If no account is specified, the default is used if one is configured. " "A local account is created with the JID as it's name if it doesn't already exist.") CMD_ARGS( { "", "The local account you wish to connect with, or a JID if connecting for the first time." }, { "server ", "Supply a server if it is different to the domain part of your JID." }, { "port ", "The port to use if different to the default (5222, or 5223 for SSL)." }, { "tls force", "Force TLS connection, and fail if one cannot be established, this is default behaviour." }, { "tls allow", "Use TLS for the connection if it is available." }, { "tls disable", "Disable TLS for the connection." }) CMD_EXAMPLES( "/connect", "/connect myuser@gmail.com", "/connect myuser@mycompany.com server talk.google.com", "/connect bob@someplace port 5678", "/connect me@localhost.test.org server 127.0.0.1 tls disable", "/connect me@chatty server chatty.com port 5443") }, { "/tls", cmd_tls, parse_args, 1, 3, NULL, CMD_TAGS( CMD_TAG_CONNECTION, CMD_TAG_UI) CMD_SYN( "/tls allow", "/tls always", "/tls deny", "/tls trusted", "/tls revoke ", "/tls certpath", "/tls certpath set ", "/tls certpath clear", "/tls show on|off") CMD_DESC( "Handle TLS certificates. ") CMD_ARGS( { "allow", "Allow connection to continue with an invalid TLS certificate." }, { "always", "Always allow connections with this invalid TLS certificate." }, { "deny", "Terminate TLS connection." }, { "trusted", "List manually trusted certificates (with /tls always)." }, { "revoke ", "Remove a manually trusted certificate." }, { "certpath", "Show the trusted certificate path." }, { "certpath set ", "Specify filesystem path containing trusted certificates." }, { "certpath clear", "Clear the trusted certificate path." }, { "show on|off", "Show or hide the TLS indicator in the titlebar." }) CMD_NOEXAMPLES }, { "/disconnect", cmd_disconnect, parse_args, 0, 0, NULL, CMD_TAGS( CMD_TAG_CONNECTION) CMD_SYN( "/disconnect") CMD_DESC( "Disconnect from the current chat service.") CMD_NOARGS CMD_NOEXAMPLES }, { "/msg", cmd_msg, parse_args_with_freetext, 1, 2, NULL, CMD_TAGS( CMD_TAG_CHAT) CMD_SYN( "/msg []", "/msg []") CMD_DESC( "Send a one to one chat message, or a private message to a chat room occupant. " "If the message is omitted, a new chat window will be opened without sending a message. " "Use quotes if the nickname includes spaces.") CMD_ARGS( { "", "Open chat window with contact, by JID or nickname." }, { " []", "Send message to contact, by JID or nickname." }, { "", "Open private chat window with chat room occupant." }, { " []", "Send a private message to a chat room occupant." }) CMD_EXAMPLES( "/msg myfriend@server.com Hey, here's a message!", "/msg otherfriend@server.com", "/msg Bob Here is a private message", "/msg \"My Friend\" Hi, how are you?") }, { "/roster", cmd_roster, parse_args_with_freetext, 0, 3, NULL, CMD_TAGS( CMD_TAG_ROSTER, CMD_TAG_UI) CMD_SYN( "/roster", "/roster online", "/roster show [offline|resource|empty]", "/roster hide [offline|resource|empty]", "/roster by group|presence|none", "/roster size ", "/roster add []", "/roster remove ", "/roster remove_all contacts", "/roster nick ", "/roster clearnick ") CMD_DESC( "Manage your roster, and roster display settings. " "Passing no arguments lists all contacts in your roster.") CMD_ARGS( { "online", "Show all online contacts in your roster." }, { "show", "Show the roster panel." }, { "show offline", "Show offline contacts in the roster panel." }, { "show resource", "Show contact's connected resources in the roster panel." }, { "show empty", "When grouping by presence, show empty presence groups." }, { "hide", "Hide the roster panel." }, { "hide offline", "Hide offline contacts in the roster panel." }, { "hide resource", "Hide contact's connected resources in the roster panel." }, { "hide empty", "When grouping by presence, hide empty presence groups." }, { "by group", "Group contacts in the roster panel by roster group." }, { "by presence", "Group contacts in the roster panel by presence." }, { "by none", "No grouping in the roster panel." }, { "size ", "Percentage of the screen taken up by the roster (1-99)." }, { "add []", "Add a new item to the roster." }, { "remove ", "Removes an item from the roster." }, { "remove_all contacts", "Remove all items from roster." }, { "nick ", "Change a contacts nickname." }, { "clearnick ", "Removes the current nickname." }) CMD_EXAMPLES( "/roster", "/roster add someone@contacts.org", "/roster add someone@contacts.org Buddy", "/roster remove someone@contacts.org", "/roster nick myfriend@chat.org My Friend", "/roster clearnick kai@server.com", "/roster size 15") }, { "/group", cmd_group, parse_args_with_freetext, 0, 3, NULL, CMD_TAGS( CMD_TAG_ROSTER, CMD_TAG_UI) CMD_SYN( "/group", "/group show ", "/group add " "/group remove ") CMD_DESC( "View, add to, and remove from roster groups. " "Passing no argument will list all roster groups.") CMD_ARGS( { "show ", "List all roster items a group." }, { "add ", "Add a contact to a group." }, { "remove ", "Remove a contact from a group." }) CMD_EXAMPLES( "/group", "/group show friends", "/group add friends newfriend@server.org", "/group add family Brother", "/group remove colleagues boss@work.com") }, { "/info", cmd_info, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_ROSTER, CMD_TAG_CHAT, CMD_TAG_GROUPCHAT) CMD_SYN( "/info", "/info |") CMD_DESC( "Show information about a contact, room, or room member. " "Passing no argument in a chat window will use the current recipient. " "Passing no argument in a chat room will display information about the room.") CMD_ARGS( { "", "The contact you wish to view information about." }, { "", "When in a chat room, the occupant you wish to view information about." }) CMD_EXAMPLES( "/info mybuddy@chat.server.org", "/info kai") }, { "/caps", cmd_caps, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_DISCOVERY, CMD_TAG_CHAT, CMD_TAG_GROUPCHAT) CMD_SYN( "/caps", "/caps |") CMD_DESC( "Find out a contacts, or room members client software capabilities. " "If in private chat initiated from a chat room, no parameter is required.") CMD_ARGS( { "", "If in the console or a chat window, the full JID for which you wish to see capabilities." }, { "", "If in a chat room, nickname for which you wish to see capabilities." }) CMD_EXAMPLES( "/caps mybuddy@chat.server.org/laptop", "/caps mybuddy@chat.server.org/phone", "/caps bruce") }, { "/software", cmd_software, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_DISCOVERY, CMD_TAG_CHAT, CMD_TAG_GROUPCHAT) CMD_SYN( "/software", "/software |") CMD_DESC( "Find out a contact, or room members software version information. " "If in private chat initiated from a chat room, no parameter is required. " "If the contact's software does not support software version requests, nothing will be displayed.") CMD_ARGS( { "", "If in the console or a chat window, the full JID for which you wish to see software information." }, { "", "If in a chat room, nickname for which you wish to see software information." }) CMD_EXAMPLES( "/software mybuddy@chat.server.org/laptop", "/software mybuddy@chat.server.org/phone", "/software bruce") }, { "/status", cmd_status, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_CHAT, CMD_TAG_GROUPCHAT) CMD_SYN( "/status", "/status |") CMD_DESC( "Find out a contact, or room members presence information. " "If in a chat window the parameter is not required, the current recipient will be used.") CMD_ARGS( { "", "The contact who's presence you which to see." }, { "", "If in a chat room, the occupant who's presence you wish to see." }) CMD_EXAMPLES( "/status buddy@server.com", "/status jon") }, { "/resource", cmd_resource, parse_args, 1, 2, &cons_resource_setting, CMD_TAGS( CMD_TAG_CHAT, CMD_TAG_UI) CMD_SYN( "/resource set ", "/resource off", "/resource title on|off", "/resource message on|off") CMD_DESC( "Override chat session resource, and manage resource display settings.") CMD_ARGS( { "set ", "Set the resource to which messages will be sent." }, { "off", "Let the server choose which resource to route messages to." }, { "title on|off", "Show or hide the current resource in the titlebar." }, { "message on|off", "Show or hide the resource when showing an incoming message." }) CMD_NOEXAMPLES }, { "/join", cmd_join, parse_args, 0, 5, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/join", "/join [nick ] [password ]") CMD_DESC( "Join a chat room at the conference server. " "If no room is supplied, a generated name will be used with the format private-chat-[UUID]. " "If the domain part is not included in the room name, the account preference 'muc.service' will be used. " "If no nickname is specified the account preference 'muc.nick' will be used which by default is the localpart of your JID. " "If the room doesn't exist, and the server allows it, a new one will be created.") CMD_ARGS( { "", "The chat room to join." }, { "nick ", "Nickname to use in the room." }, { "password ", "Password if the room requires one." }) CMD_EXAMPLES( "/join", "/join jdev@conference.jabber.org", "/join jdev@conference.jabber.org nick mynick", "/join private@conference.jabber.org nick mynick password mypassword", "/join jdev") }, { "/leave", cmd_leave, parse_args, 0, 0, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/leave") CMD_DESC( "Leave the current chat room.") CMD_NOARGS CMD_NOEXAMPLES }, { "/invite", cmd_invite, parse_args_with_freetext, 1, 2, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/invite []") CMD_DESC( "Send an invite to a contact for the current chat room.") CMD_ARGS( { "", "The contact you wish to invite." }, { "", "An optional message to send with the invite." }) CMD_NOEXAMPLES }, { "/invites", cmd_invites, parse_args_with_freetext, 0, 0, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/invites") CMD_DESC( "Show all rooms that you have been invited to, and not accepted or declined.") CMD_NOARGS CMD_NOEXAMPLES }, { "/decline", cmd_decline, parse_args_with_freetext, 1, 1, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/decline ") CMD_DESC( "Decline a chat room invitation.") CMD_ARGS( { "", "The room for the invite you wish to decline." }) CMD_NOEXAMPLES }, { "/room", cmd_room, parse_args, 1, 1, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/room accept|destroy|config") CMD_DESC( "Chat room configuration.") CMD_ARGS( { "accept", "Accept default room configuration." }, { "destroy", "Reject default room configuration, and destroy the room." }, { "config", "Edit room configuration." }) CMD_NOEXAMPLES }, { "/kick", cmd_kick, parse_args_with_freetext, 1, 2, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/kick []") CMD_DESC( "Kick occupant from chat room.") CMD_ARGS( { "", "Nickname of the occupant to kick from the room." }, { "", "Optional reason for kicking the occupant." }) CMD_NOEXAMPLES }, { "/ban", cmd_ban, parse_args_with_freetext, 1, 2, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/ban []") CMD_DESC( "Ban user from chat room.") CMD_ARGS( { "", "Bare JID of the user to ban from the room." }, { "", "Optional reason for banning the user." }) CMD_NOEXAMPLES }, { "/subject", cmd_subject, parse_args_with_freetext, 0, 2, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/subject set ", "/subject edit ", "/subject prepend ", "/subject append ", "/subject clear") CMD_DESC( "Set, modify, or clear room subject.") CMD_ARGS( { "set ", "Set the room subject." }, { "edit ", "Edit the current room subject, tab autocompletion will display the subject to edit." }, { "prepend ", "Prepend text to the current room subject, use double quotes if a trailing space is needed." }, { "append ", "Append text to the current room subject, use double quotes if a preceeding space is needed." }, { "clear", "Clear the room subject." }) CMD_NOEXAMPLES }, { "/affiliation", cmd_affiliation, parse_args_with_freetext, 1, 4, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/affiliation set []", "/list []") CMD_DESC( "Manage room affiliations. " "Affiliation may be one of owner, admin, member, outcast or none.") CMD_ARGS( { "set []", "Set the affiliation of user with jid, with an optional reason." }, { "list []", "List all users with the specified affiliation, or all if none specified." }) CMD_NOEXAMPLES }, { "/role", cmd_role, parse_args_with_freetext, 1, 4, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/role set []", "/list []") CMD_DESC( "Manage room roles. " "Role may be one of moderator, participant, visitor or none.") CMD_ARGS( { "set []", "Set the role of occupant with nick, with an optional reason." }, { "list []", "List all occupants with the specified role, or all if none specified." }) CMD_NOEXAMPLES }, { "/occupants", cmd_occupants, parse_args, 1, 3, cons_occupants_setting, CMD_TAGS( CMD_TAG_GROUPCHAT, CMD_TAG_UI) CMD_SYN( "/occupants show|hide [jid]", "/occupants default show|hide [jid]", "/occupants size []") CMD_DESC( "Show or hide room occupants, and occupants panel display settings.") CMD_ARGS( { "show", "Show the occupants panel in current room." }, { "hide", "Hide the occupants panel in current room." }, { "show jid", "Show jid in the occupants panel in current room." }, { "hide jid", "Hide jid in the occupants panel in current room." }, { "default show|hide", "Whether occupants are shown by default in new rooms." }, { "default show|hide jid", "Whether occupants jids are shown by default in new rooms." }, { "size ", "Percentage of the screen taken by the occupants list in rooms (1-99)." }) CMD_NOEXAMPLES }, { "/form", cmd_form, parse_args, 1, 2, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/form show", "/form submit", "/form cancel", "/form help []") CMD_DESC( "Form configuration.") CMD_ARGS( { "show", "Show the current form." }, { "submit", "Submit the current form." }, { "cancel", "Cancel changes to the current form." }, { "help []", "Display help for form, or a specific field." }) CMD_NOEXAMPLES }, { "/rooms", cmd_rooms, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/rooms []") CMD_DESC( "List the chat rooms available at the specified conference service. " "If no argument is supplied, the account preference 'muc.service' is used, 'conference.' by default.") CMD_ARGS( { "", "The conference service to query." }) CMD_EXAMPLES( "/rooms conference.jabber.org") }, { "/bookmark", cmd_bookmark, parse_args, 0, 8, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/bookmark", "/bookmark list", "/bookmark add [nick ] [password ] [autojoin on|off]", "/bookmark update [nick ] [password ] [autojoin on|off]", "/bookmark remove ", "/bookmark join ") CMD_DESC( "Manage bookmarks and join bookmarked rooms. " "In a chat room, no arguments will bookmark the current room, setting autojoin to \"on\".") CMD_ARGS( { "list", "List all bookmarks." }, { "add ", "Add a bookmark." }, { "remove ", "Remove a bookmark." }, { "update ", "Update the properties associated with a bookmark." }, { "nick ", "Nickname used in the chat room." }, { "password ", "Password if required, may be stored in plaintext on your server." }, { "autojoin on|off", "Whether to join the room automatically on login." }, { "join ", "Join room using the properties associated with the bookmark." }) CMD_NOEXAMPLES }, { "/disco", cmd_disco, parse_args, 1, 2, NULL, CMD_TAGS( CMD_TAG_DISCOVERY) CMD_SYN( "/disco info []", "/disco items []") CMD_DESC( "Find out information about an entities supported services. " "Calling with no arguments will query the server you are currently connected to.") CMD_ARGS( { "info []", "List protocols and features supported by an entity." }, { "items []", "List items associated with an entity." }) CMD_EXAMPLES( "/disco info", "/disco items myserver.org", "/disco items conference.jabber.org", "/disco info myfriend@server.com/laptop") }, { "/lastactivity", cmd_lastactivity, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_PRESENCE) CMD_SYN( "/lastactivity on|off", "/lastactivity []") CMD_DESC( "Enable/disable sending last activity, and send last activity requests.") CMD_ARGS( { "on|off", "Enable or disable sending of last activity." }, { "", "The JID of the entity to query, omitting the JID will query your server." }) CMD_EXAMPLES( "/lastactivity", "/lastactivity off", "/lastactivity alice@securechat.org", "/lastactivity alice@securechat.org/laptop", "/lastactivity someserver.com") }, { "/nick", cmd_nick, parse_args_with_freetext, 1, 1, NULL, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/nick ") CMD_DESC( "Change your nickname in the current chat room.") CMD_ARGS( { "", "Your new nickname." }) CMD_NOEXAMPLES }, { "/win", cmd_win, parse_args, 1, 1, NULL, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/win ") CMD_DESC( "Move to the specified window.") CMD_ARGS( { "", "Window number to display." }) CMD_NOEXAMPLES }, { "/wins", cmd_wins, parse_args, 0, 3, NULL, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/wins tidy", "/wins autotidy on|off", "/wins prune", "/wins swap ") CMD_DESC( "Manage windows. " "Passing no argument will list all currently active windows and information about their usage.") CMD_ARGS( { "tidy", "Move windows so there are no gaps." }, { "autotidy on|off", "Automatically remove gaps when closing windows." }, { "prune", "Close all windows with no unread messages, and then tidy so there are no gaps." }, { "swap ", "Swap windows, target may be an empty position." }) CMD_NOEXAMPLES }, { "/sub", cmd_sub, parse_args, 1, 2, NULL, CMD_TAGS( CMD_TAG_ROSTER) CMD_SYN( "/sub request []", "/sub allow []", "/sub deny []", "/sub show []", "/sub sent", "/sub received") CMD_DESC( "Manage subscriptions to contact presence. " "If jid is omitted, the contact of the current window is used.") CMD_ARGS( { "request []", "Send a subscription request to the user." }, { "allow []", "Approve a contact's subscription request." }, { "deny []", "Remove subscription for a contact, or deny a request." }, { "show []", "Show subscription status for a contact." }, { "sent", "Show all sent subscription requests pending a response." }, { "received", "Show all received subscription requests awaiting your response." }) CMD_EXAMPLES( "/sub request myfriend@jabber.org", "/sub allow myfriend@jabber.org", "/sub request", "/sub sent") }, { "/tiny", cmd_tiny, parse_args, 1, 1, NULL, CMD_TAGS( CMD_TAG_CHAT, CMD_TAG_GROUPCHAT) CMD_SYN( "/tiny ") CMD_DESC( "Send url as tinyurl in current chat.") CMD_ARGS( { "", "The url to make tiny." }) CMD_EXAMPLES( "Example: /tiny http://www.profanity.im") }, { "/who", cmd_who, parse_args, 0, 2, NULL, CMD_TAGS( CMD_TAG_CHAT, CMD_TAG_GROUPCHAT, CMD_TAG_ROSTER) CMD_SYN( "/who", "/who online|offline|away|dnd|xa|chat|available|unavailable|any []", "/who moderator|participant|visitor", "/who owner|admin|member") CMD_DESC( "Show contacts or room occupants with chosen status, role or affiliation") CMD_ARGS( { "offline|away|dnd|xa|chat", "Show contacts or room occupants with specified presence." }, { "online", "Contacts that are online, chat, away, xa, dnd." }, { "available", "Contacts that are available for chat - online, chat." }, { "unavailable", "Contacts that are not available for chat - offline, away, xa, dnd." }, { "any", "Contacts with any status (same as calling with no argument)." }, { "", "Filter the results by the specified roster group, not applicable in chat rooms." }, { "moderator|participant|visitor", "Room occupants with the specified role." }, { "owner|admin|member", "Room occupants with the specified affiliation." }) CMD_EXAMPLES( "/who", "/who xa", "/who online friends", "/who any family", "/who participant", "/who admin") }, { "/close", cmd_close, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/close []", "/close all|read") CMD_DESC( "Close windows. " "Passing no argument closes the current window.") CMD_ARGS( { "", "Close the specified window." }, { "all", "Close all windows." }, { "read", "Close all windows that have no unread messages." }) CMD_NOEXAMPLES }, { "/clear", cmd_clear, parse_args, 0, 0, NULL, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/clear") CMD_DESC( "Clear the current window.") CMD_NOARGS CMD_NOEXAMPLES }, { "/quit", cmd_quit, parse_args, 0, 0, NULL, CMD_NOTAGS CMD_SYN( "/quit") CMD_DESC( "Logout of any current session, and quit Profanity.") CMD_NOARGS CMD_NOEXAMPLES }, { "/privileges", cmd_privileges, parse_args, 1, 1, &cons_privileges_setting, CMD_TAGS( CMD_TAG_GROUPCHAT, CMD_TAG_UI) CMD_SYN( "/privileges on|off") CMD_DESC( "Group occupants panel by role, and show role information in chat rooms.") CMD_ARGS( { "on|off", "Enable or disable privilege information." }) CMD_NOEXAMPLES }, { "/beep", cmd_beep, parse_args, 1, 1, &cons_beep_setting, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/beep on|off") CMD_DESC( "Switch the terminal bell on or off. " "The bell will sound when incoming messages are received. " "If the terminal does not support sounds, it may attempt to flash the screen instead.") CMD_ARGS( { "on|off", "Enable or disable terminal bell." }) CMD_NOEXAMPLES }, { "/encwarn", cmd_encwarn, parse_args, 1, 1, &cons_encwarn_setting, CMD_TAGS( CMD_TAG_CHAT, CMD_TAG_UI) CMD_SYN( "/encwarn on|off") CMD_DESC( "Titlebar encryption warning.") CMD_ARGS( { "on|off", "Enabled or disable the unencrypted warning message in the titlebar." }) CMD_NOEXAMPLES }, { "/presence", cmd_presence, parse_args, 1, 1, &cons_presence_setting, CMD_TAGS( CMD_TAG_UI, CMD_TAG_CHAT) CMD_SYN( "/presence on|off") CMD_DESC( "Show the contacts presence in the titlebar.") CMD_ARGS( { "on|off", "Switch display of the contacts presence in the titlebar on or off." }) CMD_NOEXAMPLES }, { "/wrap", cmd_wrap, parse_args, 1, 1, &cons_wrap_setting, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/wrap on|off") CMD_DESC( "Word wrapping.") CMD_ARGS( { "on|off", "Enable or disable word wrapping in the main window." }) CMD_NOEXAMPLES }, { "/time", cmd_time, parse_args, 1, 3, &cons_time_setting, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/time console|chat|muc|mucconfig|private|xml set ", "/time console|chat|muc|mucconfig|private|xml off", "/time statusbar set ", "/time statusbar off", "/time lastactivity set ") CMD_DESC( "Configure time display preferences. " "Time formats are strings supported by g_date_time_format. " "See https://developer.gnome.org/glib/stable/glib-GDateTime.html#g-date-time-format for more details. " "Setting the format to an unsupported string, will display the string. " "If the format contains spaces, it must be surrounded with double quotes.") CMD_ARGS( { "console set ", "Set time format for console window." }, { "console off", "Do not show time in console window." }, { "chat set ", "Set time format for chat windows." }, { "chat off", "Do not show time in chat windows." }, { "muc set ", "Set time format for chat room windows." }, { "muc off", "Do not show time in chat room windows." }, { "mucconfig set ", "Set time format for chat room config windows." }, { "mucconfig off", "Do not show time in chat room config windows." }, { "private set ", "Set time format for private chat windows." }, { "private off", "Do not show time in private chat windows." }, { "xml set ", "Set time format for XML console window." }, { "xml off", "Do not show time in XML console window." }, { "statusbar set ", "Change time format in statusbar." }, { "statusbar off", "Do not show time in status bar." }, { "lastactivity set ", "Change time format for last activity." }) CMD_EXAMPLES( "/time main set \"%d-%m-%y %H:%M\"", "/time main off", "/time statusbar set %H:%M", "/time lastactivity set \"%d-%m-%y %H:%M\"") }, { "/inpblock", cmd_inpblock, parse_args, 2, 2, &cons_inpblock_setting, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/inpblock timeout ", "/inpblock dynamic on|off") CMD_DESC( "How long to wait for keyboard input before checking for new messages or checking for state changes such as 'idle'.") CMD_ARGS( { "timeout ", "Time to wait (1-1000) in milliseconds before reading input from the terminal buffer, default: 1000." }, { "dynamic on|off", "Start with 0 millis and dynamically increase up to timeout when no activity, default: on." }) CMD_NOEXAMPLES }, { "/notify", cmd_notify, parse_args, 2, 3, &cons_notify_setting, CMD_TAGS( CMD_TAG_UI, CMD_TAG_CHAT, CMD_TAG_GROUPCHAT) CMD_SYN( "/notify message on|off", "/notify message current on|off", "/notify message text on|off", "/notify room on|off|mention", "/notify room current on|off", "/notify room text on|off", "/notify remind ", "/notify typing on|off", "/notify typing current on|off", "/notify invite on|off", "/notify sub on|off") CMD_DESC( "Settings for various kinds of desktop notifications.") CMD_ARGS( { "message on|off", "Notifications for regular chat messages." }, { "message current on|off", "Whether messages in the current window trigger notifications." }, { "message text on|off", "Show message text in regular message notifications." }, { "room on|off|mention", "Notifications for chat room messages, mention triggers notifications only when your nick is mentioned." }, { "room current on|off", "Whether chat room messages in the current window trigger notifications." }, { "room text on|off", "Show message text in chat room message notifications." }, { "remind ", "Notification reminder period for unread messages, use 0 to disable." }, { "typing on|off", "Notifications when contacts are typing." }, { "typing current on|off", "Whether typing notifications are triggered for the current window." }, { "invite on|off", "Notifications for chat room invites." }, { "sub on|off", "Notifications for subscription requests." }) CMD_EXAMPLES( "/notify message on", "/notify message text on", "/notify room mention", "/notify room current off", "/notify room text off", "/notify remind 10", "/notify typing on", "/notify invite on") }, { "/flash", cmd_flash, parse_args, 1, 1, &cons_flash_setting, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/flash on|off") CMD_DESC( "Make the terminal flash when incoming messages are received in another window. " "If the terminal doesn't support flashing, it may attempt to beep.") CMD_ARGS( { "on|off", "Enable or disable terminal flash." }) CMD_NOEXAMPLES }, { "/intype", cmd_intype, parse_args, 1, 1, &cons_intype_setting, CMD_TAGS( CMD_TAG_UI, CMD_TAG_CHAT) CMD_SYN( "/intype on|off") CMD_DESC( "Show when a contact is typing in the console, and in active message window.") CMD_ARGS( { "on|off", "Enable or disable contact typing messages." }) CMD_NOEXAMPLES }, { "/splash", cmd_splash, parse_args, 1, 1, &cons_splash_setting, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/splash on|off") CMD_DESC( "Switch on or off the ascii logo on start up and when the /about command is called.") CMD_ARGS( { "on|off", "Enable or disable splash logo." }) CMD_NOEXAMPLES }, { "/autoconnect", cmd_autoconnect, parse_args, 1, 2, &cons_autoconnect_setting, CMD_TAGS( CMD_TAG_CONNECTION) CMD_SYN( "/autoconnect set ", "/autoconnect off") CMD_DESC( "Enable or disable autoconnect on start up. " "The setting can be overridden by the -a (--account) command line option.") CMD_ARGS( { "set ", "Connect with account on start up." }, { "off", "Disable autoconnect." }) CMD_EXAMPLES( "/autoconnect set jc@stuntteam.org", "/autoconnect off") }, { "/vercheck", cmd_vercheck, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/vercheck on|off") CMD_DESC( "Check for new versions when Profanity starts, and when the /about command is run.") CMD_ARGS( { "on|off", "Enable or disable the version check." }) CMD_NOEXAMPLES }, { "/titlebar", cmd_titlebar, parse_args, 2, 2, &cons_titlebar_setting, CMD_TAGS( CMD_TAG_UI) CMD_SYN( "/titlebar show on|off", "/titlebar goodbye on|off") CMD_DESC( "Allow Profanity to modify the window title bar.") CMD_ARGS( { "show on|off", "Show current logged in user, and unread messages as the window title." }, { "goodbye on|off", "Show a message in the title when exiting profanity." }) CMD_NOEXAMPLES }, { "/alias", cmd_alias, parse_args_with_freetext, 1, 3, NULL, CMD_NOTAGS CMD_SYN( "/alias list", "/alias add ", "/alias remove ") CMD_DESC( "Add, remove or list command aliases.") CMD_ARGS( { "list", "List all aliases." }, { "add ", "Add a new command alias." }, { "remove ", "Remove a command alias." }) CMD_EXAMPLES( "/alias add friends /who online friends", "/alias add /q /quit", "/alias a /away \"I'm in a meeting.\"", "/alias remove q", "/alias list") }, { "/chlog", cmd_chlog, parse_args, 1, 1, &cons_chlog_setting, CMD_TAGS( CMD_TAG_CHAT) CMD_SYN( "/chlog on|off") CMD_DESC( "Switch chat logging on or off. " "This setting will be enabled if /history is set to on. " "When disabling this option, /history will also be disabled. " "See the /grlog setting for enabling logging of chat room (groupchat) messages.") CMD_ARGS( { "on|off", "Enable or disable chat logging." }) CMD_NOEXAMPLES }, { "/grlog", cmd_grlog, parse_args, 1, 1, &cons_grlog_setting, CMD_TAGS( CMD_TAG_GROUPCHAT) CMD_SYN( "/grlog on|off") CMD_DESC( "Switch chat room logging on or off. " "See the /chlog setting for enabling logging of one to one chat.") CMD_ARGS( { "on|off", "Enable or disable chat room logging." }) CMD_NOEXAMPLES }, { "/states", cmd_states, parse_args, 1, 1, &cons_states_setting, CMD_TAGS( CMD_TAG_CHAT) CMD_SYN( "/states on|off") CMD_DESC( "Send chat state notifications to recipient during chat sessions, such as typing, paused, active, gone.") CMD_ARGS( { "on|off", "Enable or disable sending of chat state notifications." }) CMD_NOEXAMPLES }, { "/pgp", cmd_pgp, parse_args, 1, 3, NULL, CMD_TAGS( CMD_TAG_CHAT, CMD_TAG_UI) CMD_SYN( "/pgp libver", "/pgp keys", "/pgp contacts", "/pgp setkey ", "/pgp start []", "/pgp end", "/pgp log on|off|redact", "/pgp char ") CMD_DESC( "Open PGP commands to manage keys, and perform PGP encryption during chat sessions. " "See the /account command to set your own PGP key.") CMD_ARGS( { "libver", "Show which version of the libgpgme library is being used." }, { "keys", "List all keys known to the system." }, { "contacts", "Show contacts with assigned public keys." }, { "setkey ", "Manually associate a contact with a public key." }, { "start []", "Start PGP encrypted chat, current contact will be used if not specified." }, { "end", "End PGP encrypted chat with the current recipient." }, { "log on|off", "Enable or disable plaintext logging of PGP encrypted messages." }, { "log redact", "Log PGP encrypted messages, but replace the contents with [redacted]. This is the default." }, { "char ", "Set the character to be displayed next to PGP encrypted messages." }) CMD_EXAMPLES( "/pgp log off", "/pgp setkey buddy@buddychat.org BA19CACE5A9592C5", "/pgp start buddy@buddychat.org", "/pgp end", "/pgp char P") }, { "/otr", cmd_otr, parse_args, 1, 3, NULL, CMD_TAGS( CMD_TAG_CHAT, CMD_TAG_UI) CMD_SYN( "/otr libver", "/otr gen", "/otr myfp|theirfp", "/otr start []", "/otr end", "/otr trust|untrust", "/otr secret ", "/otr question ", "/otr answer ", "/otr policy manual|opportunistic|always []", "/otr log on|off|redact", "/otr char ") CMD_DESC( "Off The Record (OTR) commands to manage keys, and perform OTR encryption during chat sessions.") CMD_ARGS( { "libver", "Show which version of the libotr library is being used." }, { "gen", "Generate your private key." }, { "myfp", "Show your fingerprint." }, { "theirfp", "Show contacts fingerprint." }, { "start []", "Start an OTR session with contact, or current recipient if omitted." }, { "end", "End the current OTR session," }, { "trust|untrust", "Indicate whether or not you trust the contact's fingerprint." }, { "secret ", "Verify a contact's identity using a shared secret." }, { "question ", "Verify a contact's identity using a question and expected answer." }, { "answer ", "Respond to a question answer verification request with your answer." }, { "policy manual", "Set the global OTR policy to manual, OTR sessions must be started manually." }, { "policy manual ", "Set the OTR policy to manual for a specific contact." }, { "policy opportunistic", "Set the global OTR policy to opportunistic, an OTR session will be attempted upon starting a conversation." }, { "policy opportunistic ", "Set the OTR policy to opportunistic for a specific contact." }, { "policy always", "Set the global OTR policy to always, an error will be displayed if an OTR session cannot be initiated upon starting a conversation." }, { "policy always ", "Set the OTR policy to always for a specific contact." }, { "log on|off", "Enable or disable plaintext logging of OTR encrypted messages." }, { "log redact", "Log OTR encrypted messages, but replace the contents with [redacted]. This is the default." }, { "char ", "Set the character to be displayed next to OTR encrypted messages." }) CMD_EXAMPLES( "/otr log off", "/otr policy manual", "/otr policy opportunistic mrfriend@workchat.org", "/otr gen", "/otr start buddy@buddychat.org", "/otr myfp", "/otr theirfp", "/otr question \"What is the name of my rabbit?\" fiffi", "/otr end", "/otr char *") }, { "/outtype", cmd_outtype, parse_args, 1, 1, &cons_outtype_setting, CMD_TAGS( CMD_TAG_CHAT) CMD_SYN( "/outtype on|off") CMD_DESC( "Send typing notifications, chat states (/states) will be enabled if this setting is enabled.") CMD_ARGS( { "on|off", "Enable or disable sending typing notifications." }) CMD_NOEXAMPLES }, { "/gone", cmd_gone, parse_args, 1, 1, &cons_gone_setting, CMD_TAGS( CMD_TAG_CHAT) CMD_SYN( "/gone ") CMD_DESC( "Send a 'gone' state to the recipient after the specified number of minutes. " "Chat states (/states) will be enabled if this setting is set.") CMD_ARGS( { "", "Number of minutes of inactivity before sending the 'gone' state, a value of 0 will disable sending this state." }) CMD_NOEXAMPLES }, { "/history", cmd_history, parse_args, 1, 1, &cons_history_setting, CMD_TAGS( CMD_TAG_UI, CMD_TAG_CHAT) CMD_SYN( "/history on|off") CMD_DESC( "Switch chat history on or off, /chlog will automatically be enabled when this setting is on. " "When history is enabled, previous messages are shown in chat windows.") CMD_ARGS( { "on|off", "Enable or disable showing chat history." }) CMD_NOEXAMPLES }, { "/log", cmd_log, parse_args, 1, 2, &cons_log_setting, CMD_NOTAGS CMD_SYN( "/log where", "/log rotate on|off", "/log maxsize ", "/log shared on|off") CMD_DESC( "Manage profanity log settings.") CMD_ARGS( { "where", "Show the current log file location." }, { "rotate on|off", "Rotate log, default on." }, { "maxsize ", "With rotate enabled, specifies the max log size, defaults to 1048580 (1MB)." }, { "shared on|off", "Share logs between all instances, default: on. When off, the process id will be included in the log." }) CMD_NOEXAMPLES }, { "/carbons", cmd_carbons, parse_args, 1, 1, &cons_carbons_setting, CMD_TAGS( CMD_TAG_CHAT) CMD_SYN( "/carbons on|off") CMD_DESC( "Enable or disable message carbons. " "Message carbons ensure that both sides of all conversations are shared with all the user's clients that implement this protocol.") CMD_ARGS( { "on|off", "Enable or disable message carbons." }) CMD_NOEXAMPLES }, { "/receipts", cmd_receipts, parse_args, 2, 2, &cons_receipts_setting, CMD_TAGS( CMD_TAG_CHAT) CMD_SYN( "/receipts request on|off", "/receipts send on|off") CMD_DESC( "Enable or disable message delivery receipts. The interface will indicate when a message has been received.") CMD_ARGS( { "request on|off", "Whether or not to request a receipt upon sending a message." }, { "send on|off", "Whether or not to send a receipt if one has been requested with a received message." }) CMD_NOEXAMPLES }, { "/reconnect", cmd_reconnect, parse_args, 1, 1, &cons_reconnect_setting, CMD_TAGS( CMD_TAG_CONNECTION) CMD_SYN( "/reconnect ") CMD_DESC( "Set the reconnect attempt interval for when the connection is lost.") CMD_ARGS( { "", "Number of seconds before attempting to reconnect, a value of 0 disables reconnect." }) CMD_NOEXAMPLES }, { "/autoping", cmd_autoping, parse_args, 1, 1, &cons_autoping_setting, CMD_TAGS( CMD_TAG_CONNECTION) CMD_SYN( "/autoping ") CMD_DESC( "Set the interval between sending ping requests to the server to ensure the connection is kept alive.") CMD_ARGS( { "", "Number of seconds between sending pings, a value of 0 disables autoping." }) CMD_NOEXAMPLES }, { "/ping", cmd_ping, parse_args, 0, 1, NULL, CMD_TAGS( CMD_TAG_CONNECTION) CMD_SYN( "/ping []") CMD_DESC( "Sends an IQ ping stanza to the specified JID. " "If no JID is supplied, your chat server will be pinged.") CMD_ARGS( { "", "The Jabber ID to send the ping request to." }) CMD_NOEXAMPLES }, { "/autoaway", cmd_autoaway, parse_args_with_freetext, 2, 3, &cons_autoaway_setting, CMD_TAGS( CMD_TAG_PRESENCE) CMD_SYN( "/autoaway mode idle|away|off", "/autoaway time away|xa ", "/autoaway message away|xa |off", "/autoaway check on|off") CMD_DESC( "Manage autoway settings for idle time.") CMD_ARGS( { "mode idle", "Sends idle time, status remains online." }, { "mode away", "Sends away and xa presence as well as idle time." }, { "mode off", "Disabled (default)." }, { "time away ", "Number of minutes before the away presence is sent, default: 15." }, { "time xa ", "Number of minutes before the xa presence is sent, default: 0 (disabled)." }, { "message away ", "Optional message to send with the away presence, default: off (disabled)." }, { "message xa ", "Optional message to send with the xa presence, default: off (disabled)." }, { "message away off", "Send no message with away presence." }, { "message xa off", "Send no message with xa presence." }, { "check on|off", "When enabled, checks for activity and sends online presence, default: on." }) CMD_EXAMPLES( "/autoaway mode away", "/autoaway time away 30", "/autoaway message away Away from computer for a while", "/autoaway time xa 120", "/autoaway message xa Away from computer for a very long time", "/autoaway check off") }, { "/priority", cmd_priority, parse_args, 1, 1, &cons_priority_setting, CMD_TAGS( CMD_TAG_PRESENCE) CMD_SYN( "/priority ") CMD_DESC( "Set priority for the current account. " "See the /account command for specific priority settings per presence status.") CMD_ARGS( { "", "Number between -128 and 127, default: 0." }) CMD_NOEXAMPLES }, { "/account", cmd_account, parse_args, 0, 4, NULL, CMD_TAGS( CMD_TAG_CONNECTION CMD_TAG_PRESENCE, CMD_TAG_CHAT, CMD_TAG_GROUPCHAT) CMD_SYN( "/account", "/account list", "/account show ", "/account enable|disable ", "/account default set ", "/account default off", "/account add ", "/account remove ", "/account rename ", "/account set jid ", "/account set server ", "/account set port ", "/account set status ", "/account set status last", "/account set ", "/account set resource ", "/account set password ", "/account set eval_password ", "/account set muc ", "/account set nick ", "/account set otr ", "/account set pgpkeyid ", "/account set startscript