commands/sms/sms.cif
author Tom Sutcliffe <thomas.sutcliffe@accenture.com>
Sun, 17 Oct 2010 18:43:12 +0100
changeset 86 849a0b46c767
parent 0 7f656887cf89
permissions -rw-r--r--
Fixed lots of issues with installing a low-caps version of fshell from SIS file. * Fixed issue in CCommandFactory whereby some APIs like GetCommandInfoL could trigger allocations on the wrong heap or signals to the wrong thread. The symptoms were often seen as a crash in the which_00 thread when running ciftest. * Lots of build fixes for when FSHELL_PROTECTED_UIDS isn't defined and when all capabilities aren't available. * Added new platform.mmh macro FSHELL_OPEN_SIGNED. * Open signing of fshell SIS files is now supported for production S60 handsets. Build fshell with the FSHELL_OPEN_SIGNED macro defined (and without defining FSHELL_CAP_ALL or FSHELL_PROTECTED_UIDS) in your platform.mmh and submit \epoc32\fshell\fshell.unsigned.sis to https://www.symbiansigned.com/app/page/public/openSignedOnline.do . The following commands are not available when using Open Signing due to Platform Security restrictions: fdb; kerninfo; chunkinfo; svrinfo; objinfo; sudo; fsck; localdrive; ramdefrag; readmem; reboot; setcritical; setpriority. Others such as chkdeps, e32header, ps, and fshell itself will run but in a restricted capacity (for example, fshell will no longer allow you to modify files in the \sys\bin directory). * Removed commands objinfo, svrinfo, chunkinfo, readmem, fsck completely when memory access isn't present - previously they would still appear in the help but would give an error if you tried to run them.

# sms.cif
# 
# Copyright (c) 2010 Accenture. All rights reserved.
# This component and the accompanying materials are made available
# under the terms of the "Eclipse Public License v1.0"
# which accompanies this distribution, and is available
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
# 
# Initial Contributors:
# Accenture - Initial contribution
#

==name sms

==short-description

Send or receive text messages.

==long-description

The send functionality simply sends a text message to the specified mobile phone number. The receive functionality is intended to allow the handset it's running on to be remotely controlled. Any SMS that is received which started with C<#!fshell> or C<#!perl> is intercepted from the user's messaging inbox and instead is executed as a script. The script can make use of the environment variable SMS_SENDER with is set to the phone number that sent the message.

Note, use of receive mode represents a significant security risk. It is recommended that the C<--match> option be used to restrict which sending parties the handset will allow control from.

==argument enum command

The action to perform.

==enum-value send

Send an SMS.

==enum-value receive

Receive, intercept and execute all SMSs that start with C<#!fshell> or C<#!perl>.

==argument string message optional last

The text to send. If not specified, C<send> will read from C<STDIN>.

==option string d destination

The destination of the SMS. This option is required when sending an SMS, and ignored otherwise.

==option bool n no-delete

Scripts that are received are stored in F<C:\shared\fshellN.script> (and F<perlN.pl>) while they are being executed. By default they are deleted when the script completes. Specify this option to not delete them - useful if you need to debug or examine a script.

==option string m match multiple

A match string to limit the numbers from which shebang messages will be processed. Shebang messages from numbers that do not match will be discarded. Supports C<TDesC::Match> style wildcards.

==copyright

Copyright (c) 2008-2010 Accenture. All rights reserved.