X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=server.cmd;h=18e1ab6cfdc5476eb7b08708d7ea738b308d925c;hp=3053ab002e2dae867d92928973064ea0b18340fd;hb=e63886e85c55c99e9732e5715b7ce641eff09914;hpb=b5f38f4a67a64dd4215568c3537c8dc90dd8a21e diff --git a/server.cmd b/server.cmd index 3053ab00..18e1ab6c 100644 --- a/server.cmd +++ b/server.cmd @@ -1,21 +1,15 @@ -FN: server_command_list +OF: server_command_list +SF: command.c HC: prototypes for the server command handlers CC: array of server commands AT: server_command -IN: server user_list +IN: para error string afh afs server list user_list SN: list of server commands --- -N: chs -P: DB_READ | DB_WRITE -D: change the current audio file selector -S: chs [new_selector] -H: Shutdown the current selector and activate new_selector. If no -H: argument was given, print the name of the current selector. ---- N: ff P: VSS_READ | VSS_WRITE D: jump amount of time forwards or backwards in current audio file -S: ff n[-] +U: ff n[-] H: Set the 'R' (reposition request) bit of the vss status flags H: and enqueue a request to jump n seconds forwards or backwards H: in the current audio file. @@ -29,22 +23,22 @@ H: jumps 30 seconds backwards. N: help P: 0 D: print help text -S: help [command] -H: Without any arguments, help prints a list of availible commands. When +U: help [command] +H: Without any arguments, help prints a list of available commands. When H: issued with a command name as first argument, print out a description H: for that command. --- N: hup P: VSS_WRITE -D: force reload of config file and log file -S: hup -H: After rereading the config file, a signal is sent to all children -H: which forces them to close/reopen the log file. +D: force reload of config file, log file and user list +U: hup +H: Reread the config file and the user list file, close and reopen the log +H: file, and tell all children to do the same. --- N: jmp P: VSS_READ | VSS_WRITE D: jump to given position in current audio file -S: jmp [n] +U: jmp [n] H: Set the 'R' (reposition request) bit of the vss status flags H: and enqueue a request to jump to n% of the current audio file, H: where 0 <= n <= 100. @@ -52,7 +46,7 @@ H: where 0 <= n <= 100. N: next P: VSS_READ | VSS_WRITE D: skip rest of current audio file -S: next +U: next H: Set the 'N' (next audio file) bit of the vss status flags. When H: playing, change audio file immediately. Equivalent to stop H: if paused, NOP if stopped. @@ -60,7 +54,7 @@ H: if paused, NOP if stopped. N: nomore P: VSS_READ | VSS_WRITE D: stop playing after current audio file -S: nomore +U: nomore H: Set the 'O' (no more) bit of the vss status flags. This instructs H: para_server to clear the 'P' (playing) bit as soon as it encounters H: the 'N' (next audio file) bit being set. @@ -70,41 +64,20 @@ H: sudden endings. N: pause P: VSS_READ | VSS_WRITE D: pause current audio file -S: pause +U: pause H: Clear the 'P' (playing) bit of the vss status flags. --- N: play P: VSS_READ | VSS_WRITE D: start playing or resume playing when paused -S: play +U: play H: Set the 'P' (playing) bit of the vss status flags. This H: results in starting/continuing to stream. --- -N: sb -P: VSS_READ -D: print status bar for current audio file -S: sb [n] -H: Without any arguments, sb continuously prints a status bar of the -H: form -H: -H: 12:34 [56:12] (56%) filename -H: -H: indicating playing time, remaining time, percentage and the name of -H: the file being streamed. Use the optional number n to let stat exit -H: after having displayed the status bar n times. ---- -N: sc -P: VSS_READ -D: print name of audio file whenever it changes -S: sc [n] -H: sc prints exactly one line (the filename of the audio file -H: being played) whenever the audio file changes. Stops after -H: n iterations, or never if n is not specified. ---- N: sender P: VSS_READ | VSS_WRITE D: control paraslash internal senders -S: sender [s cmd [arguments]] +U: sender [s cmd [arguments]] H: send command cmd to sender s. cmd may be one of the following: H: help, on, off, add, delete, allow, or deny. Note that not all senders H: support each command. Try e.g. 'para_client sender http help' for @@ -114,13 +87,13 @@ H: print out a list of all senders that are compiled in. N: si P: 0 D: print server info -S: si +U: si H: Print server uptime and other information. --- N: stat P: VSS_READ D: print status info for current audio file -S: stat [n] +U: stat [n] H: Without any arguments, stat continuously prints status messages H: about the audio file being streamed. Use the optional number n H: to let stat exit after having displayed status n times. @@ -128,19 +101,19 @@ H: to let stat exit after having displayed status n times. N: stop P: VSS_READ | VSS_WRITE D: stop playing -S: stop +U: stop H: Clear the 'P' (play) bit and set the 'N' bit of the vss status H: flags. --- N: term P: VSS_READ | VSS_WRITE D: terminate para_server -S: term +U: term H: Shuts down the server. Instead of this command, you can also send H: SIGINT or SIGTERM. It should never be necessary to send SIGKILL. --- N: version P: 0 D: print server's version -S: version +U: version H: Show version and other info