13.7.20. SYS_GET_CMDLINE (0x15)

Returns the command-line used to call the executable.

Entry

On entry, r1 points to a two word data block in which the command string and its length are to be returned:

word 1

is a pointer to a buffer of at least the number of bytes specified in word two.

word 2

is the length of the buffer.

Return

On exit:

  • Register r1 points to a two word data block:

    word 1

    is a pointer to null-terminated string of the command line.

    word 2

    is the length of the string.

    The debug agent might impose limits on the maximum length of the string that can be transferred. However, the agent must be able to transfer a command-line of at least 80 bytes.

    In the case of the Angel debug monitor using ADP, the minimum is slightly more than 200 characters.

  • Register r0 contains an error code:

    • 0 if the call is successful

    • –1 if the call is unsuccessful (for example, because of a communications error).

Copyright © 1997, 1998 ARM Limited. All rights reserved.ARM DUI 0040D
Non-Confidential