5.4.19. SYS_GET_CMDLINE (0x15)

Returns the command line used to call the executable.

Entry

On entry, r1 points to a two-word data block to be used for returning the command string and its length:

word 1

This is a pointer to a buffer of at least the size specified in word two.

word 2

This is the length of the buffer in bytes.

Return

On exit:

  • Register r1 points to a two-word data block:

    word 1

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

    word 2

    This 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 maximum 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 © 1999-2001 ARM Limited. All rights reserved.ARM DUI0058D
Non-Confidential