Fork of ipxe; additional commands and features https://git.openslx.org/openslx-ng/ipxe.git/atom/src/doc/pxe_extensions?h=v1.0.0 2010-01-24T12:54:42+00:00 2010-01-24T12:54:42+00:00 Shao Miller 2010-01-24T03:12:27+00:00 urn:sha1:112a3f2de281a2afb23ced2082d555720de7c9b0 It might be the case that we wish to chain to an NBP without being "in the way". We now implement a hook in our exit path for gPXE *.*pxe build targets. The hook is a pointer to a SEG16:OFF16 which we try to jump to during exit. By default, this pointer results in the usual exit path. We also implement the "pxenv_file_exit_hook" PXE API routine to allow the user to specify an alternate SEG16:OFF16 to jump to during exit. Unfortunately, this additional PXE extension has a cost in code size. Fortunately, a look at the size difference for a gPXE .rom build target shows zero size difference after compression. The routine is documented in doc/pxe_extensions as follows: FILE EXIT HOOK Op-Code: PXENV_FILE_EXIT_HOOK (00e7h) Input: Far pointer to a t_PXENV_FILE_EXIT_HOOK parameter structure that has been initialized by the caller. Output: PXENV_EXIT_SUCCESS or PXENV_EXIT_FAILURE must be returned in AX. The Status field in the parameter structure must be set to one of the values represented by the PXENV_STATUS_xxx constants. Description:Modify the exit path to jump to the specified code. Only valid for pxeprefix-based builds. typedef struct s_PXENV_FILE_EXIT_HOOK { PXENV_STATUS_t Status; SEGOFF16_t Hook; } t_PXENV_FILE_EXIT_HOOK; Set before calling API service: Hook: The SEG16:OFF16 of the code to jump to. Returned from API service: Status: See PXENV_STATUS_xxx constants. Requested-by: H. Peter Anvin <hpa@zytor.com> Signed-off-by: Shao Miller <shao.miller@yrdsb.edu.on.ca> Signed-off-by: Marty Connor <mdc@etherboot.org> 2008-03-26T22:14:55+00:00 H. Peter Anvin 2008-03-26T22:14:55+00:00 urn:sha1:d810dc5be24d0d5aa63a90c710292772f7495824 Add documentation for the FILE_EXEC and FILE_CHECK_API extension calls, and update the documentation for the FILE_READ call. 2007-07-06T12:31:40+00:00 Michael Brown 2007-07-06T12:31:40+00:00 urn:sha1:bfc335faa8c20661d2a69e56436b51344936b475 Documented non-blocking nature of PXENV_FILE_READ. Changed FileName field in PXENV_FILE_OPEN to be a SEGOFF16, to avoid a fixed 256-byte length limit on URLs. 2007-07-05T17:03:09+00:00 Michael Brown 2007-07-05T17:03:09+00:00 urn:sha1:d64e1be1f8ac01dce56ec0a230d2e261559bcad9