NAME

xucpclient - Sonera Short Message Service (SMS) client


SYNOPSIS

xucpclient [options] <message>


DESCRIPTION

xucpclient is a Short Message Service (SMS) client that sends messages via a Sonera XUCP server.

To operate xucpclient, you will need an authentication file to be present as either /etc/xucpclientrc or ~/.xucpclientrc. This file should have the form:

$login = ``xxxxx'';

$passwd = ``yyyyy'';

where the details between the quotes are available only to authorised Sonera personnel.

Options

-d
Turn on debugging messages.

-e <DDMMYYHHMM|+mins>
Set an expiry date for the message, after which it will be discarded if it is still pending. If provided in DDMMYYHHMM format, the time should be given in Eastern European Time (EET), the time zone of Finland.

The days, months and years may be separated by either '/' or '-', the date and time may be separated by a '^', and the hours and minutes may be separated by a ':'. All of these separators are optional and are provided purely to improve human legibililty.

More flexible is the +mins format, which will expire the message a given number of minutes from the current time.

-l <user>
Log into server as this user.

-n
Log into server, but don't send the message.

-p <password>
Log into server using this password.

-r <recipients>
List of recipients. The list should be supplied as a single parameter (i.e. multiple entries should be single quoted), and may consist of either telephone numbers or telephone book entries.

A telephone number should be supplied in its full international form, e.g. +31651123456, although you may use 00 instead of the prefix '+'.

A telephone book is one or both of /etc/xucpphonebook and ~/.xucpphonebook. These files should contain entries of the form user=number. White space on either side of the '=' is allowed.

-s <sender>
This option may be used to supply a number that will appear to have initiated the message. If this is not supplied, the recipient number will be duplicated as the sender number.

-t
Truncate message if more than 150 characters.

-v
Run in verbose mode.


EXAMPLES

xucpclient -de 25/09/99^12:05 -s +31651123456 -r 0611 Hi
Send the message ``Hi'' to +31651123456, stating that it came from 0611. Debugging messages will be displayed and, if the message cannot be sent by 12:05 on 25th September 1999, it will be discarded.

xucpclient -e +120 -s +31651123456 Got there in 2 hours
Send a message to expire 2 hours from now if undelivered.

/usr/games/fortune -sn 150 | xucpclient -vr 0031651123456
Send a suitably short fortune cookie to 0031651123456, sending the message to stdout in the process. The sender's number will appear the same as the recipient's.

Try this in your .procmailrc:
:0 c

* ^From.*company.com

| formail -X ``From:'' -X ``Subject:'' | \ xucpclient -r +31651123456

This will alert you whenever you receive an e-mail from somebody at company.com.


AUTHOR

Ian Macdonald <ian@caliban.org>


BUGS

Probably. Send me your diffs.


FILES

/etc/xucpclientrc, ~/.xucpclientrc, /etc/xucpphonebook, ~/./xucpphonebook