Index: stand/libsa/libsa.3 =================================================================== --- stand/libsa/libsa.3 +++ stand/libsa/libsa.3 @@ -687,6 +687,47 @@ Devices are exported by the supporting code via the array .Vt struct devsw *devsw[] which is a NULL terminated array of pointers to device switch structures. +.Sh DRIVER INTERFACE +The driver needs to provide a common set of entry points that are +used by +.Nm libsa +to interface with the device. +.Bd -literal +struct devsw { + const char dv_name[DEV_NAMLEN]; + int dv_type; + int (*dv_init)(void); + int (*dv_strategy)(void *devdata, int rw, daddr_t blk, + size_t size, char *buf, size_t *rsize); + int (*dv_open)(struct open_file *f, ...); + int (*dv_close)(struct open_file *f); + int (*dv_ioctl)(struct open_file *f, u_long cmd, void *data); + int (*dv_print)(int verbose); + void (*dv_cleanup)(void); +}; +.Ed +.Bl -tag -width ".Fn dv_strategy" +.It Fn dv_name +The name this device is known as. +.It Fn dv_type +Gross class of device type. +.It Fn dv_init +Driver initialization routine. +This routine should probe for available units. +Drivers is responsible for maintaining lists of units for later enumeration. +.It Fn dv_open +The driver open routine. +.It Fn dv_close +The driver close routine. +.It Fn dv_ioctl +The driver ioctl routine. +.It Fn dv_print +Prints information about the available devices. +Information should be presented with +.Fn pager_output . +.It Fn dv_cleanup +Cleans up any memory used by the device before the next stage is run. +.El .Sh HISTORY The .Nm