commands/fcontacts/fcontacts.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.

# fcontacts.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 fcontacts

==short-description

Queries the contacts database.

==long-description

Note, all dates are shown in UTC.

==see-also

L<fcalendar|fcalendar>

==argument enum command optional

The command to execute. Defaults to C<list>.

==enum-value list

List all contacts. Use C<-i> to specify a contact identifier or C<-m> to specify a match sting to list a sub-set of contacts.

==enum-value add

Add a contact. Use options C<-f>, C<-s>, C<-t> and C<-b> to specify the contact's details.

==enum-value delete

Delete a contact. Use C<-i> to specify the identifier of the contact entry to be deleted.

==enum-value change

Change an existing contact. Use C<-i> to specify the identifier of the contact entry to be changed. Use options C<-f>, C<-s>, C<-m> and C<-t> to specify the new details. Unspecified details will remain the same.

==enum-value delete-all

Delete all contacts in the database.

==enum-value create-group

Create a new group. Use C<-g> to specify the group's name.

==enum-value add-to-group

Add a contact to a group. Use C<-i> and C<-d> to specify the contact and group identifiers.

==enum-value compact

Compact the database.

==option bool v verbose multiple

Shows all fields. Specify twice (i.e. C<-vv>) for even more detail about field mappings.

==option uint i contact-id

Specify the identifier of a contact.

==option uint d group-id

Specify the identifer of a group. Used when adding a contact to a group.

==option string m match

A match string to limit what contacts are shown. Only valid with the C<list> command. Can contain wild-cards C<*> and C<?>.

==option bool o first-phone-only

Only print the first phone number of the first matching contact. Only valid with the C<list> command, and if C<--verbose> has not been specified.

==option string f first-name

Specify the contact's first name.

==option string l last-name

Specify the contact's last name.

==option string t telephone

Specify the contact's general telephone number.

==option string b mobile

Specify the contact's mobile phone number.

==option filename p photo

Specify the name of a file that contains a photo or logo of the contact.

==option string g group

Specify the name of a group. Used when creating a new group.

==copyright

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