core/builtins/error.cif
author Joe Branton <joe.branton@accenture.com>
Thu, 29 Jul 2010 12:02:58 +1000
changeset 14 4ab8c027df23
parent 0 7f656887cf89
permissions -rw-r--r--
Fixed a defect in iosrv.exe that caused a panic if a foreground read object was attached to a different end point. This was due to the read object being notified of a change in foreground before its iEndPoint member was updated. This member is now updated before attempting the attach, and is set to NULL in the event of a leave (resulting in the read object being left in an unattached state). Also tweaked ymodem.cif to make it more readable.

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

==short-description

Exits with the given error. Useful in scripts.

==long-description

This command exits with the given error and optionally prints the specified text to stderr. This is useful to abort scripts, for example as a precondition check:

	# Some setup...
	var SOMEVARIABLE not-defined && error -6 "The variable SOMEVARIABLE must be defined before you run this script"
	
	# Rest of script...

==argument int error-number optional

The error code to exit with. Must be negative. If not specified, defaults to C<KErrAbort> (-39).

==argument string text optional

If specified, prints the given text to stderr before exiting.

==copyright

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