Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.18.7  shel_read                                                  TOS

 Name:         »Shell read« - Read command line parameters of the 
               application.

 Opcode:       120

 Syntax:       int16_t shel_read ( int8_t *sh_rpcmd, int8_t *sh_rptail 
               );

 Description:  The call shel_read obtains the name and the command 
               line tail with which an application was launched. The 
               following apply:

                Parameter  Meaning

                sh_rpcmd   Complete pathname with program name
                sh_rptail  Command line (according to Pexec, so NULL- 
                           terminated and with length specified in 
                           first byte)

               Note: The function only works correctly if the appli- 
               cation was launched with shel_write. In case of doubt, 
               therefore, one should fall back to the values from the 
               basepage.

 Return value: An error has arisen only if the value 0 is returned.

 Availability: All AES versions.

 Group:        Shell library

 See Also:     Binding   shel_write   Pexec