Cauxin() waits for the next available data byte from GEMDOS handle 2 (normally device 'aux:') and when available, returns it in the low byte of the returned WORD.

3 (0x03)

All GEMDOS versions.

	move.w  #$3,-(sp)
	trap  #1
	addq.l  #2,sp

The WORD value contains the retrieved byte in the lower eight bits. The contents of the upper 8 bits are currently undefined.

This function can cause flow control problems.

When using this function while its handle is redirected, an end-of-file condition will hang the system. GEMDOS version 0.30 and all MiNT versions correct this bug. MiNT returns MINT_EOF (0xFF1A) when the end-of-file is reached.

In addition, if this handle is redirected to something other than 'aux:', an end-of-file will hang the system. Besides these known bugs, this function is used by many 'C' compilers to redirect standard error messages. It is therefore advisable to use Bconin() instead.

Cauxis(), Cauxout(), Bconin()