Datasheet

Semihosting

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).