PXENV_FILE_READ
[PXE FILE API]

FILE READ. More...

Data Structures
struct	s_PXENV_FILE_READ
	Parameter block for pxenv_file_read(). More...
Defines
#define	PXENV_FILE_READ   0x00e3
	PXE API function code for pxenv_file_read().
Typedefs
typedef struct s_PXENV_FILE_READ	PXENV_FILE_READ_t
Functions
PXENV_EXIT_t	pxenv_file_read (struct s_PXENV_FILE_READ *file_read)
	FILE READ.

---

Detailed Description

FILE READ.

---

Define Documentation

#define PXENV_FILE_READ   0x00e3

PXE API function code for pxenv_file_read().

Definition at line 1693 of file pxe_api.h.

Referenced by pxe_api_call().

---

Typedef Documentation

typedef struct s_PXENV_FILE_READ PXENV_FILE_READ_t

Definition at line 1703 of file pxe_api.h.

---

Function Documentation

PXENV_EXIT_t pxenv_file_read

(

struct s_PXENV_FILE_READ *

file_read

)

FILE READ.

Parameters:

	file_read	Pointer to a struct s_PXENV_FILE_READ
	s_PXENV_FILE_READ::FileHandle	File handle
	s_PXENV_FILE_READ::BufferSize	Size of data buffer
	s_PXENV_FILE_READ::Buffer	Data buffer

Return values:

	PXENV_EXIT_SUCCESS	Data has been read from file
	PXENV_EXIT_FAILURE	Data has not been read from file
	s_PXENV_FILE_READ::Status	PXE status code
	s_PXENV_FILE_READ::Ready	Indication of readiness
	s_PXENV_FILE_READ::BufferSize	Length of data read

Definition at line 146 of file pxe_file.c.

References s_PXENV_FILE_READ::Buffer, s_PXENV_FILE_READ::BufferSize, DBG, s_PXENV_FILE_READ::FileHandle, s_SEGOFF16::offset, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS, PXENV_STATUS_SUCCESS, read_user(), real_to_user(), s_SEGOFF16::segment, and s_PXENV_FILE_READ::Status.

Referenced by pxe_api_call().

                                                                     {
        userptr_t buffer;
        ssize_t len;

        DBG ( "PXENV_FILE_READ %d to %04x:%04x+%04x", file_read->FileHandle,
              file_read->Buffer.segment, file_read->Buffer.offset,
              file_read->BufferSize );

        buffer = real_to_user ( file_read->Buffer.segment,
                                file_read->Buffer.offset );
        if ( ( len = read_user ( file_read->FileHandle, buffer, 0,
                                file_read->BufferSize ) ) < 0 ) {
                file_read->Status = PXENV_STATUS ( len );
                return PXENV_EXIT_FAILURE;
        }

        DBG ( " read %04zx", ( ( size_t ) len ) );

        file_read->BufferSize = len;
        file_read->Status = PXENV_STATUS_SUCCESS;
        return PXENV_EXIT_SUCCESS;
}