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-Fileshel_get()
Shell Library
shel_put()                                                              AES

Syntax

WORD shel_put( buf, length )
char *buf;
WORD length;

Function       shel_put() copies information into the AES's shell buffer.

Opcode         123 (0x7B)

Availability   All AES versions.

Parameters     buf points to a user memory buffer from which length bytes
               are to be copied into the shell buffer.

Binding        intin[0] = length;

               addrin[0] = buf;

               return crys_if(0x7B);

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

Version Notes  Prior to AES version 4.0 this function would only copy as
               many bytes as would fit into the current buffer. As of
               version 4.0, the AES will dynamically allocate more memory
               as needed (up to 32767 bytes) for the shell buffer.

Comments       The Desktop uses the information in the shell buffer for
               several purposes. Applications should not use the shell
               buffer for their own purposes.

See Also       shel_get()

Group          Shell Library