Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

fldigi-shell(1) [debian man page]

FLDIGI-SHELL(1) 														   FLDIGI-SHELL(1)

NAME

       fldigi-shell - program for controlling fldigi

SYNOPSIS

       fldigi-shell [OPTIONS] [FILE]

DESCRIPTION

       The fldigi-shell program controls fldigi(1) over HTTP via XML-encoded remote procedure calls (XML-RPC). It can call any XML-RPC method
       exported by fldigi, and also defines some useful commands of its own.

OPTIONS

       -d
	   Enable debug output.

       -u URL
	   Use URL to access the server. Defaults to "http://localhost:7362/RPC2", which corresponds to fldigi's default listen address and port.

       -c COMMAND
	   Execute command COMMAND and exit.

COMMANDS

	   Note
	   The "x:yz" notation refers to the return type and argument type(s). They are: "n" (nil), "i" (integer), and "s" (string).

       debug (n:n:)
	   Toggle debug output.

       eval (s:s)
	   Evaluate Perl code.

       exit (n:n)
	   Exit the shell.

       help (n:n)
	   Print help for server (fldigi) methods and shell commands.

       history (s:n)
	   Print command history.

       modems (s:n)
	   List all modem names.

       poll (s:i)
	   Poll for new received text every i seconds. Defaults to 1.

       pskrqsy (n:si)
	   QSY to ith best frequency for grid s. The list of frequencies is retrieved from the PSK Reporter website; see RESOURCES. The grid
	   square string may be left empty, and the index argument defaults to 0 (first frequency).

       recvtext (s:n)
	   Get all received text.

       reinit (n:n)
	   Fetch commands from the server and rebuild command list.

       send (n:s)
	   Send text interactively, one line at a time.

       sendchar (n:s)
	   Send text interactively, one character at a time.

       sendfile (n:s)
	   Send text read from file s.

       sendstr (n:s)
	   Send string s.

       source (n:s)
	   Read commands from file s.

       time (s:s)
	   Time a command.

       wait (n:s)
	   Wait for server TRX state to become s.

EXTENDED DESCRIPTION

       The shell has three modes of operation:

	1. Interactive mode with history, tab completion and command line editing. This is the default mode when fldigi-shell is run without
	   arguments.

	2. Batch mode for a single command with the -c option.

	3. Batch mode to "source" a file containing Perl code. Fldigi-shell commands can be called using "execute("COMMAND [ARG ...]")" calls.

FILES

       $HOME/.fldigi/shell-history
	   Contains the fldigi-shell command history.

EXAMPLES

       while :; do fldigi-shell -c pskrqsy; sleep 900; done
	   Change to the "best frequency" (see PSK Reporter) every fifteen minutes.

SEE ALSO

       fldigi(1), xmlrpc(1), readline(3), RPC::XML(3pm)

BUGS

       o   Some additional command wrappers are needed.

       o   Command completion should be enabled for the arguments of some commands.

       o   The XML-RPC handling code should probably go in a separate module.

       o   It should be possible to pass multiple -c CMD arguments.

RESOURCES

       Fldigi web site: http://www.w1hkj.com/Fldigi.html

       The PSK Automatic Propagation Reporter site can be found at http://www.pskreporter.info/

       The GNU Readline Library: http://directory.fsf.org/project/readline/

       XML-RPC home page: http://www.xmlrpc.com/

AUTHOR

       Fldigi-shell and this manual page were written by Stelios Bounanos, M0GLD <sb[at]enotty(dot)net>.

COPYING

       License GPLv2+: GNU GPL version 2 or later.

								    07/01/2012							   FLDIGI-SHELL(1)

Check Out this Related Man Page

SHELL-QUOTE(1p) 					User Contributed Perl Documentation					   SHELL-QUOTE(1p)

NAME

       shell-quote - quote arguments for safe use, unmodified in a shell command

SYNOPSIS

       shell-quote [switch]... arg...

DESCRIPTION

       shell-quote lets you pass arbitrary strings through the shell so that they won't be changed by the shell.  This lets you process commands
       or files with embedded white space or shell globbing characters safely.	Here are a few examples.

EXAMPLES

       ssh preserving args
	   When running a remote command with ssh, ssh doesn't preserve the separate arguments it receives.  It just joins them with spaces and
	   passes them to "$SHELL -c".	This doesn't work as intended:

	       ssh host touch 'hi there'	   # fails

	   It creates 2 files, hi and there.  Instead, do this:

	       cmd=`shell-quote touch 'hi there'`
	       ssh host "$cmd"

	   This gives you just 1 file, hi there.

       process find output
	   It's not ordinarily possible to process an arbitrary list of files output by find with a shell script.  Anything you put in $IFS to
	   split up the output could legitimately be in a file's name.	Here's how you can do it using shell-quote:

	       eval set -- `find -type f -print0 | xargs -0 shell-quote --`

       debug shell scripts
	   shell-quote is better than echo for debugging shell scripts.

	       debug() {
		   [ -z "$debug" ] || shell-quote "debug:" "$@"
	       }

	   With echo you can't tell the difference between "debug 'foo bar'" and "debug foo bar", but with shell-quote you can.

       save a command for later
	   shell-quote can be used to build up a shell command to run later.  Say you want the user to be able to give you switches for a command
	   you're going to run.  If you don't want the switches to be re-evaluated by the shell (which is usually a good idea, else there are
	   things the user can't pass through), you can do something like this:

	       user_switches=
	       while [ $# != 0 ]
	       do
		   case x$1 in
		       x--pass-through)
			   [ $# -gt 1 ] || die "need an argument for $1"
			   user_switches="$user_switches "`shell-quote -- "$2"`
			   shift;;
		       # process other switches
		   esac
		   shift
	       done
	       # later
	       eval "shell-quote some-command $user_switches my args"

OPTIONS

       --debug
	   Turn debugging on.

       --help
	   Show the usage message and die.

       --version
	   Show the version number and exit.

AVAILABILITY

       The code is licensed under the GNU GPL.	Check http://www.argon.org/~roderick/ or CPAN for updated versions.

AUTHOR

       Roderick Schertler <roderick@argon.org>

perl v5.8.4							    2005-05-03							   SHELL-QUOTE(1p)
Man Page