Rechercher une page de manuel
somaclient
Langue: en
Version: 22 Feb 2007 (mandriva - 01/05/08)
Section: 1 (Commandes utilisateur)
NAME
somaclient - client for the soma daemonSYNOPSIS
somaclient [-S server ] [-P port ] [-U unix_socket ] [-ssl] -[pPASSWORD] [-pw] [-rd] [-rp] [-rs] [-fp new_palinsesto ] [-op] [-gp] [-gop] [-dp] [-fs new_spot ] [-os] [-gs] [-gos] [-ds] [-st] [-gi] [-gin] [-ns nextitem ] [-nsl] [-nsr ID ] [-nsss set_spot ] [-nsgs] [-nsgp] [-pn] [-r] [-q] [-sk] [-skn] [-1] [-0] [-rso ID ] [-rsp ID ] [-sp] [-up] [-gps] [-gss] [-c] [-h]DESCRIPTION
Somaclient provides an interface to the soma daemon. With this we can change the run parameters of Somad at runtime.Somaclient has two modes of use, in comand-line, or in shell mode. In both the commands are the same (in shell mode without the initials '-'), but in shell mode it maintains a open connection with the running somad, and we can send commands to it without quit the application.
To start in shell mode, run somaclient without any option.
The shell ends with the 'quit' or 'exit' commands. There is some help with the 'help' and '?' commands. Other especial shell commands are 'cd' (change to directory DIR), 'pwd' (print the current working directory) and 'ls' or 'list' (list files in DIR).
OPTIONS
- -S, --server
- Connect to this server.
- -P, --port
- Connect to this port.
- -U, --unix
- Connect to this unix socket path.
- -ssl
- Crypt the connection
- -pPASSWORD
- Use the password to connect. If you don't use this flag, somaclient asks you the password.
- -pw, --password
- Check only the password
- -rd, --readdirectory
- Reread and remap soma's directories into memory. Use this if files have been removed or changed that are used by soma.
- -rp, --readpalinsesto
- Reread the palinsesto file and remap it's setting in memory.
- -rs, --readspot
- Reread the spot file and remap it's setting in memory.
- -fp, --filepalinsesto
- Specify a new palinsesto file.
- -op, --oldpalinsesto
- Reload the original palinsesto file (the one in the soma.cfg file).
- -gp, --getpalinsesto
- Show palinsesto file soma currently is using.
- -gop, --getoldpalinsesto
- Show old palinsesto file.
- -dp, --setdefaultpalinsesto
- Set this palinsesto as default (overwrite /etc/somad/palinsesto.cfg)
- -fs, --filespot
- Specify a new spot file.
- -os, --oldspot
- Reload the original spot file.
- -gs, --getspot
- Show spot file soma currently is using.
- -gos, --getoldspot
- Show old spot file.
- -ds, --setdefaultspot
- Set this spot as default (overwrite /etc/somad/spot.cfg)
- -st, --status
- Display what task the soma daemo is currently doing.
- -gi, --get_item
- Gets the current item of somad.
- -gin, --get_item_next
- Gets the following item of somad.
- -ns, --nextitem
- Specify the next item runtime. Somad saves the input in a list so you can make a playlist. If we uses a ':' prior the file, somad analize this file as in the DistribuitedPath (see soma.cfg(5) man page).
- -nsl, --nextitemlist
- Show the list of nextitem.
- -nsr, --nextitemremove
- Remove a item of nextitem list. You can use as argoment "first" and "last" for remove the first item or the last or a number [0 to max]
- -nsss, --nextitemsetspot
- Set the iteration with spot elements. 0 disactive, 1 active.
- -nsgs, --nextitemgetspot
- Get the iteration with spot elements. 0 disactive, 1 active.
- -nsgp, --nextitemgetpath
- Return the list of files in a shared directory activated.
- -pn, --palinsestoname
- Returns the name of current palinsesto.
- -r, --running
- Display if the soma daemon is active or not.
- -q, --quit
- Stop definitively the soma daemon. Warning! this option stop and quits the daemon (see --stop option too).
- -sk, --skip
- Skip the current item and pass to the next item.
- -skn, --skipnext
- Skip the next item, but don't affect the current.
- -1, --stop
- Stop playing the current palinsesto. The daemon don't quits, so we can start it with the following command (--start). When a stop occurs, somad kills the player and waits for a start. When the start comes, it restarts the current trasmission from scratch. We can pass to the daemon some info about the time that it should be stopped too. This time is indicated in hours (with 'H' or 'h'), minutes ('M' or 'm'), seconds ('S' or 's'), or any mix of all (1H20m4s per example). If none is indicated, secons is the default.
- -0, --start
- Start playing the current palinsesto after a "stop" (see above).
- -rso, --removeitem
- Removes a item by the numeric ID.
- -rsp, --removespot
- Removes a spot by the numeric ID.
- -sp, --setpause
- Set a pause in Somad. When a pause occurs, Somad waits for the end of current item, stops itself and waits for a unpause. When the unpause arrives, somad restarts the transmission exactly in the previous point.
- -up, --unsetpause
- Remove the pause flags and restart the transmission (see above).
- -gps, --getpause
- Print the pause flags (says if a pause is active (true) or not (false)).
- -gss, --getstop
- Print the Stop flags (says if a stop is active (true) or not (false)).
- -c, --code
- Instead of running a message it will return on the following error codes.
0 Generic Error. 1 Error in Parameters. 2 Error Creating Socket. 3 Error Resolving Host. 4 Error Connecting to Server 5 Communication Error Between the Somaclient and Soma daemon. 6 Incorrect Password. 7 Success. 8 Soma Client Error. 9 Unable to perform action in soma daemon (10 second lock timeout: only if somad is compiled with SM). 10 The Soma daemon is playing audio. 11 The Soma daemon is stopped. 12 The Soma daemon use spot in nextitem list 13 The Soma daemon does not use spot in nextitem list
- -h, --help
- Output a short summary of available command line options.
AUTHOR
Somad written by Andrea Marchesini <bakunin@autistici.org> Man page written by Joshua Eichen <joshua@bitmine.net.net> Man page updated by Martin Zelaia <martintxo@sindominio.net> for soma-2.4.
SEE ALSO
somad(1), soma.cfg(5), palinsesto.cfg(5), spot.cfg(5), somacheck(1), somaplayer(1), somax(1), somax-editor(1) somax-nextitem(1) somax-config(1)http://www.somasuite.org/
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre