Software / code / prosody
Annotate
man/prosodyctl.man @ 4416:03e1295d599a
Merge with Zash
| author | Matthew Wild <mwild1@gmail.com> |
|---|---|
| date | Fri, 18 Nov 2011 16:05:40 +0000 |
| parent | 2699:1ae8a1ac93bd |
| child | 7032:817c7b197ac7 |
| rev | line source |
|---|---|
| 1464 | 1 .TH PROSODYCTL 1 "2009-07-02" |
| 2 | |
| 3 .SH NAME | |
| 4 prosodyctl \- Manage a Prosody XMPP server | |
| 5 | |
| 6 .SH SYNOPSIS | |
| 7 \fBprosodyctl\fP \fIcommand\fP [\fI--help\fP] | |
| 8 | |
| 9 .SH DESCRIPTION | |
| 10 \fBprosodyctl\fP is the control tool for the Prosody XMPP server. It may be | |
| 11 used to control the server daemon and manage users. | |
| 12 | |
| 13 \fBprosodyctl\fP needs to be executed with sufficient privileges to perform | |
| 14 its commands. This typically means executing \fBprosodyctl\fP as the root user. | |
| 15 If a user named "prosody" is found then \fBprosodyctl\fP will change to that | |
| 16 user before executing its commands. | |
| 17 | |
| 18 .SH COMMANDS | |
| 19 .SS User Management | |
| 20 In the following commands users are identified by a Jabber ID, \fIjid\fP, of the | |
| 21 usual form: user@domain. | |
| 22 | |
| 23 .IP "\fBadduser\fP \fIjid\fP" | |
| 24 Adds a user with Jabber ID, \fIjid\fP, to the server. You will be | |
| 25 prompted to enter the user's password. | |
| 26 | |
| 27 .IP "\fBpasswd\fP \fIjid\fP" | |
| 28 Changes the password of an existing user with Jabber ID, \fIjid\fP. You will be | |
| 29 prompted to enter the user's new password. | |
| 30 | |
| 31 .IP "\fBdeluser\fP \fIjid\fP" | |
| 32 Deletes an existing user with Jabber ID, \fIjid\fP, from the server. | |
| 33 | |
| 34 .SS Daemon Management | |
| 35 Although \fBprosodyctl\fP has commands to manage the \fBprosody\fP daemon it is | |
| 36 recommended that you utilize your distributions daemon management features if | |
| 37 you attained Prosody through a package. | |
| 38 | |
| 39 To perform daemon control commands \fBprosodyctl\fP needs a \fIpidfile\fP value | |
| 40 specified in \fI/etc/prosody/prosody.cfg.lua\fP. Failure to do so will cause | |
| 41 \fBprosodyctl\fP to complain. | |
| 42 | |
| 43 .IP \fBstart\fP | |
| 44 Starts the \fBprosody\fP server daemon. If run as root \fBprosodyctl\fP will | |
| 45 attempt to change to a user named "prosody" before executing. This operation | |
| 46 will block for up to five seconds to wait for the server to execute. | |
| 47 | |
| 48 .IP \fBstop\fP | |
| 49 Stops the \fBprosody\fP server daemon. This operation will block for up to five | |
| 50 seconds to wait for the server to stop executing. | |
| 51 | |
|
2698
4ca70ac5aa92
prosodyctl.man: Include new restart command
Dwayne Bent <dbb.1@liqd.org>
parents:
1464
diff
changeset
|
52 .IP \fBrestart\fP |
|
4ca70ac5aa92
prosodyctl.man: Include new restart command
Dwayne Bent <dbb.1@liqd.org>
parents:
1464
diff
changeset
|
53 Restarts the \fBprosody\fP server daemon. Equivalent to running \fBprosodyctl |
|
4ca70ac5aa92
prosodyctl.man: Include new restart command
Dwayne Bent <dbb.1@liqd.org>
parents:
1464
diff
changeset
|
54 stop\fP followed by \fBprosodyctl start\fP. |
|
4ca70ac5aa92
prosodyctl.man: Include new restart command
Dwayne Bent <dbb.1@liqd.org>
parents:
1464
diff
changeset
|
55 |
| 1464 | 56 .IP \fBstatus\fP |
| 57 Prints the current execution status of the \fBprosody\fP server daemon. | |
| 58 | |
| 59 .SS Ejabberd Compatibility | |
| 60 \fBejabberd\fP is another XMPP server which provides a comparable control tool, | |
| 61 \fBejabberdctl\fP, to control its server's operations. \fBprosodyctl\fP | |
| 62 implements some commands which are compatible with \fBejabberdctl\fP. For | |
| 63 details of how these commands work you should see | |
| 64 .BR ejabberdctl (8). | |
| 65 | |
| 66 .IP "\fBregister\fP \fIuser server password\fP" | |
| 67 .IP "\fBunregister\fP \fIuser server\fP" | |
| 68 | |
| 69 .SH OPTIONS | |
| 70 .IP \fI--help\fP | |
| 71 Display help text for the specified command. | |
| 72 | |
| 73 .SH FILES | |
| 74 .IP \fI/etc/prosody/prosody.cfg.lua\fP | |
| 75 The main \fBprosody\fP configuration file. \fBprosodyctl\fP reads this to | |
| 76 determine the process ID file of the \fBprosody\fP server daemon and to | |
| 77 determine if a host has been configured. | |
| 78 | |
| 79 .SH ONLINE | |
| 80 More information may be found online at: \fIhttp://prosody.im/\fP | |
| 81 | |
| 82 .SH AUTHORS | |
|
2699
1ae8a1ac93bd
prosodyctl.man: Update email address
Dwayne Bent <dbb.1@liqd.org>
parents:
2698
diff
changeset
|
83 Dwayne Bent <dbb.1@liqd.org> |
