Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileShell Library
shel_read()                                                             AES

Syntax

WORD shel_read( name, tail )
char *name, *tail;

Function       shel_read() is used to determine the current application's
               parent and the command tail used to call it.

Opcode         120 (0x78)

Availability   All AES versions.

Parameters     name points to a buffer which upon exit will be filled in
               with the complete file specification of the application
               which launched the current process.
               tail will likewise be filled in with the initial command
               line. The first BYTE of the command line indicates the
               length of the string which actually begins at &tail[1].

Binding        addrin[0] = name;
               addrin[1] = tail;

               return crys_if(0x78);

Return Value   shel_read() returns 0 if an error occurred or non-zero
               otherwise.

Caveats        shel_read() actually returns the arguments to the last
               shel_write() so if a process was Pexec()'ed, the
               information returned will be incorrect.

Group          Shell Library