2005-04-08 17:01:17 +02:00
|
|
|
#ifndef LIBRM_H
|
|
|
|
#define LIBRM_H
|
|
|
|
|
|
|
|
/* Drag in protected-mode segment selector values */
|
|
|
|
#include "virtaddr.h"
|
|
|
|
#include "realmode.h"
|
|
|
|
|
|
|
|
#ifndef ASSEMBLY
|
|
|
|
|
|
|
|
#include "stddef.h"
|
|
|
|
#include "string.h"
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Data structures and type definitions
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
2006-05-06 20:57:31 +02:00
|
|
|
/* Access to variables in .data16 and .text16 */
|
2006-05-04 19:00:20 +02:00
|
|
|
extern char *data16;
|
2006-05-06 20:57:31 +02:00
|
|
|
extern char *text16;
|
2006-05-04 19:00:20 +02:00
|
|
|
|
|
|
|
#define __data16( variable ) \
|
2006-05-24 01:42:45 +02:00
|
|
|
__attribute__ (( section ( ".data16" ) )) \
|
|
|
|
_data16_ ## variable __asm__ ( #variable )
|
|
|
|
|
|
|
|
#define __data16_array( variable, array ) \
|
|
|
|
__attribute__ (( section ( ".data16" ) )) \
|
|
|
|
_data16_ ## variable array __asm__ ( #variable )
|
2006-05-04 19:00:20 +02:00
|
|
|
|
2006-05-06 20:57:31 +02:00
|
|
|
#define __text16( variable ) \
|
2006-05-24 01:42:45 +02:00
|
|
|
__attribute__ (( section ( ".text16.data" ) )) \
|
|
|
|
_text16_ ## variable __asm__ ( #variable )
|
|
|
|
|
|
|
|
#define __text16_array( variable, array ) \
|
|
|
|
__attribute__ (( section ( ".text16.data" ) )) \
|
|
|
|
_text16_ ## variable array __asm__ ( #variable )
|
2006-05-06 20:57:31 +02:00
|
|
|
|
2006-05-04 19:00:20 +02:00
|
|
|
#define __use_data16( variable ) \
|
|
|
|
( * ( ( typeof ( _data16_ ## variable ) * ) \
|
|
|
|
& ( data16 [ ( size_t ) & ( _data16_ ## variable ) ] ) ) )
|
|
|
|
|
2006-05-06 20:57:31 +02:00
|
|
|
#define __use_text16( variable ) \
|
|
|
|
( * ( ( typeof ( _text16_ ## variable ) * ) \
|
|
|
|
& ( text16 [ ( size_t ) & ( _text16_ ## variable ) ] ) ) )
|
|
|
|
|
2006-05-13 13:11:55 +02:00
|
|
|
#define __from_data16( variable ) \
|
|
|
|
( * ( ( typeof ( variable ) * ) \
|
|
|
|
( ( ( void * ) &(variable) ) - ( ( void * ) data16 ) ) ) )
|
|
|
|
|
|
|
|
#define __from_text16( variable ) \
|
|
|
|
( * ( ( typeof ( variable ) * ) \
|
|
|
|
( ( ( void * ) &(variable) ) - ( ( void * ) text16 ) ) ) )
|
|
|
|
|
2006-05-02 17:41:21 +02:00
|
|
|
/* Variables in librm.S, present in the normal data segment */
|
|
|
|
extern uint16_t rm_sp;
|
|
|
|
extern uint16_t rm_ss;
|
|
|
|
extern uint32_t pm_esp;
|
2006-05-13 13:45:31 +02:00
|
|
|
extern uint16_t __data16 ( rm_cs );
|
|
|
|
#define rm_cs __use_data16 ( rm_cs )
|
|
|
|
extern uint16_t __text16 ( rm_ds );
|
|
|
|
#define rm_ds __use_text16 ( rm_ds )
|
2005-04-10 18:44:49 +02:00
|
|
|
|
2005-04-08 17:01:17 +02:00
|
|
|
/* Functions that librm expects to be able to link to. Included here
|
|
|
|
* so that the compiler will catch prototype mismatches.
|
|
|
|
*/
|
|
|
|
extern void gateA20_set ( void );
|
|
|
|
|
|
|
|
/*
|
|
|
|
* librm_mgmt: functions for manipulating base memory and executing
|
|
|
|
* real-mode code.
|
|
|
|
*
|
|
|
|
* Full API documentation for these functions is in realmode.h.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Macro for obtaining a physical address from a segment:offset pair. */
|
|
|
|
#define VIRTUAL(x,y) ( phys_to_virt ( ( ( x ) << 4 ) + ( y ) ) )
|
|
|
|
|
|
|
|
/* Copy to/from base memory */
|
2006-05-13 13:11:55 +02:00
|
|
|
static inline __attribute__ (( always_inline )) void
|
|
|
|
copy_to_real_librm ( unsigned int dest_seg, unsigned int dest_off,
|
|
|
|
void *src, size_t n ) {
|
2005-04-08 17:01:17 +02:00
|
|
|
memcpy ( VIRTUAL ( dest_seg, dest_off ), src, n );
|
|
|
|
}
|
2006-05-13 13:11:55 +02:00
|
|
|
static inline __attribute__ (( always_inline )) void
|
|
|
|
copy_from_real_librm ( void *dest, unsigned int src_seg,
|
|
|
|
unsigned int src_off, size_t n ) {
|
2005-04-08 17:01:17 +02:00
|
|
|
memcpy ( dest, VIRTUAL ( src_seg, src_off ), n );
|
|
|
|
}
|
|
|
|
#define put_real_librm( var, dest_seg, dest_off ) \
|
|
|
|
do { \
|
|
|
|
* ( ( typeof(var) * ) VIRTUAL ( dest_seg, dest_off ) ) = var; \
|
|
|
|
} while ( 0 )
|
|
|
|
#define get_real_librm( var, src_seg, src_off ) \
|
|
|
|
do { \
|
|
|
|
var = * ( ( typeof(var) * ) VIRTUAL ( src_seg, src_off ) ); \
|
|
|
|
} while ( 0 )
|
|
|
|
#define copy_to_real copy_to_real_librm
|
|
|
|
#define copy_from_real copy_from_real_librm
|
|
|
|
#define put_real put_real_librm
|
|
|
|
#define get_real get_real_librm
|
|
|
|
|
2006-05-19 17:06:51 +02:00
|
|
|
/**
|
|
|
|
* A pointer to a user buffer
|
|
|
|
*
|
|
|
|
* Even though we could just use a void *, we use an intptr_t so that
|
|
|
|
* attempts to use normal pointers show up as compiler warnings. Such
|
|
|
|
* code is actually valid for librm, but not for libkir (i.e. under
|
|
|
|
* KEEP_IT_REAL), so it's good to have the warnings even under librm.
|
|
|
|
*/
|
|
|
|
typedef intptr_t userptr_t;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Copy data to user buffer
|
|
|
|
*
|
|
|
|
* @v buffer User buffer
|
|
|
|
* @v offset Offset within user buffer
|
|
|
|
* @v src Source
|
|
|
|
* @v len Length
|
|
|
|
*/
|
|
|
|
static inline __attribute__ (( always_inline )) void
|
|
|
|
copy_to_user ( userptr_t buffer, off_t offset, const void *src, size_t len ) {
|
|
|
|
memcpy ( ( void * ) buffer + offset, src, len );
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Copy data from user buffer
|
|
|
|
*
|
|
|
|
* @v dest Destination
|
|
|
|
* @v buffer User buffer
|
|
|
|
* @v offset Offset within user buffer
|
|
|
|
* @v len Length
|
|
|
|
*/
|
|
|
|
static inline __attribute__ (( always_inline )) void
|
|
|
|
copy_from_user ( void *dest, userptr_t buffer, off_t offset, size_t len ) {
|
|
|
|
memcpy ( dest, ( void * ) buffer + offset, len );
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Convert virtual address to user buffer
|
|
|
|
*
|
|
|
|
* @v virtual Virtual address
|
|
|
|
* @ret buffer User buffer
|
|
|
|
*
|
|
|
|
* This constructs a user buffer from an ordinary pointer. Use it
|
|
|
|
* when you need to pass a pointer to an internal buffer to a function
|
|
|
|
* that expects a @c userptr_t.
|
|
|
|
*/
|
|
|
|
static inline __attribute__ (( always_inline )) userptr_t
|
|
|
|
virt_to_user ( void * virtual ) {
|
|
|
|
return ( ( intptr_t ) virtual );
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Convert segment:offset address to user buffer
|
|
|
|
*
|
|
|
|
* @v segment Real-mode segment
|
|
|
|
* @v offset Real-mode offset
|
|
|
|
* @ret buffer User buffer
|
|
|
|
*/
|
|
|
|
static inline __attribute__ (( always_inline )) userptr_t
|
|
|
|
real_to_user ( unsigned int segment, unsigned int offset ) {
|
|
|
|
return virt_to_user ( VIRTUAL ( segment, offset ) );
|
|
|
|
}
|
|
|
|
|
2005-04-08 17:01:17 +02:00
|
|
|
/* Copy to/from real-mode stack */
|
|
|
|
extern uint16_t copy_to_rm_stack ( void *data, size_t size );
|
|
|
|
extern void remove_from_rm_stack ( void *data, size_t size );
|
|
|
|
|
|
|
|
/* Place/remove parameter on real-mode stack in a way that's
|
|
|
|
* compatible with libkir
|
|
|
|
*/
|
|
|
|
#define BASEMEM_PARAMETER_INIT_LIBRM( param ) \
|
|
|
|
copy_to_rm_stack ( & ( param ), sizeof ( param ) )
|
|
|
|
#define BASEMEM_PARAMETER_DONE_LIBRM( param ) \
|
|
|
|
remove_from_rm_stack ( & ( param ), sizeof ( param ) )
|
|
|
|
#define BASEMEM_PARAMETER_INIT BASEMEM_PARAMETER_INIT_LIBRM
|
|
|
|
#define BASEMEM_PARAMETER_DONE BASEMEM_PARAMETER_DONE_LIBRM
|
|
|
|
|
|
|
|
/* REAL_FRAGMENT: Declare and define a real-mode code fragment in .text16 */
|
|
|
|
#define REAL_FRAGMENT( name, asm_code_str ) \
|
|
|
|
extern void name ( void ); \
|
|
|
|
__asm__ __volatile__ ( \
|
2006-05-14 15:39:27 +02:00
|
|
|
".section \".text16\", \"ax\", @progbits\n\t" \
|
2005-04-08 17:01:17 +02:00
|
|
|
".code16\n\t" \
|
|
|
|
".arch i386\n\t" \
|
|
|
|
#name ":\n\t" \
|
|
|
|
asm_code_str "\n\t" \
|
2006-05-02 17:41:21 +02:00
|
|
|
"ret\n\t" \
|
2006-05-02 18:38:46 +02:00
|
|
|
".size " #name ", . - " #name "\n\t" \
|
2005-04-08 17:01:17 +02:00
|
|
|
".code32\n\t" \
|
|
|
|
".previous\n\t" \
|
|
|
|
: : \
|
|
|
|
)
|
|
|
|
#define FRAGMENT_SIZE( fragment ) ( (size_t) fragment ## _size )
|
|
|
|
|
|
|
|
/* REAL_CALL: call a real-mode routine via librm */
|
|
|
|
#define OUT_CONSTRAINTS(...) __VA_ARGS__
|
2006-05-02 17:41:21 +02:00
|
|
|
#define IN_CONSTRAINTS(...) __VA_ARGS__
|
2005-04-08 17:01:17 +02:00
|
|
|
#define CLOBBER(...) __VA_ARGS__
|
2006-05-02 17:41:21 +02:00
|
|
|
#define REAL_CALL( routine, num_out_constraints, out_constraints, \
|
|
|
|
in_constraints, clobber ) \
|
|
|
|
do { \
|
|
|
|
__asm__ __volatile__ ( \
|
|
|
|
"pushl $" #routine "\n\t" \
|
|
|
|
"call real_call\n\t" \
|
|
|
|
"addl $4, %%esp\n\t" \
|
|
|
|
: out_constraints \
|
|
|
|
: in_constraints \
|
|
|
|
: clobber \
|
|
|
|
); \
|
2005-04-08 17:01:17 +02:00
|
|
|
} while ( 0 )
|
|
|
|
|
|
|
|
/* REAL_EXEC: combine RM_FRAGMENT and REAL_CALL into one handy unit */
|
|
|
|
#define PASSTHRU(...) __VA_ARGS__
|
|
|
|
#define REAL_EXEC( name, asm_code_str, num_out_constraints, out_constraints, \
|
|
|
|
in_constraints, clobber ) \
|
|
|
|
do { \
|
|
|
|
REAL_FRAGMENT ( name, asm_code_str ); \
|
|
|
|
\
|
2006-05-02 17:41:21 +02:00
|
|
|
REAL_CALL ( name, num_out_constraints, \
|
2005-04-08 17:01:17 +02:00
|
|
|
PASSTHRU ( out_constraints ), \
|
|
|
|
PASSTHRU ( in_constraints ), \
|
|
|
|
PASSTHRU ( clobber ) ); \
|
|
|
|
} while ( 0 )
|
|
|
|
|
|
|
|
#endif /* ASSEMBLY */
|
|
|
|
|
|
|
|
#endif /* LIBRM_H */
|