This library contains special functions, which are only available on FreeGEM.
• xshl_getshell | Gets the name of the desktop |
• xshl_setshell | Sets the name of the desktop |
See also: About the AES
Name: | »Shell get« - Get the name of the desktop program to use.
|
Opcode: | 1030
|
Syntax: | int16_t xshl_getshell ( int8_t *shell );
|
Description: | The call xshl_getshell serves to get the name of the desktop
program. shell specifies the buffer to receive the shell
filename.
|
Return value: | This function returns 0 if standard shell (DESKTOP.APP) in use;
1 if it was overridden by use of GEM.CFG or xshl_setshell.
|
Availability: | This call is a compile-time option in recent FreeGEM versions.
To check for this feature, use appl_init(xbuf) and check that bit 4 of
xbuf.abilities is set (ABLE_XSHL).
|
Group: | Extended shell library
|
See also: | Binding xshl_setshell
|
C: | int16_t xshl_getshell ( int8_t *shell );
| ||||||||||||||||||||||||
Binding: |
int16_t xshl_getshell (int8_t *shell ) { addr_in[0] = shell; return ( crys_if(1030) ); } | ||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Shell set« - Set the name of the desktop program to use.
|
Opcode: | 1031
|
Syntax: | int16_t xshl_setshell ( int8_t *shell );
|
Description: | The call xshl_setshell serves to set the name of the desktop
program. shell specifies the name of the shell (no path, it
must always be in \GEMAPPS\GEMSYS).
Note: A normal GEM program is not suitable for use as a shell, since when it terminates it will be immediately re-run. |
Return value: | This function returns 0 if the desktop program was set, or 1 if
the name was too long (more than 15 characters).
|
Availability: | This call is a compile-time option in recent FreeGEM versions.
To check for this feature, use appl_init(xbuf) and check that bit 4 of
xbuf.abilities is set (ABLE_XSHL).
|
Group: | Extended shell library
|
See also: | Binding xshl_getshell
|
C: | int16_t xshl_setshell ( int8_t *shell );
| ||||||||||||||||||||||||
Binding: |
int16_t xshl_setshell (int8_t *shell ) { addr_in[0] = shell; return ( crys_if(1031) ); } | ||||||||||||||||||||||||
GEM-Arrays: |
|