/* ---------------------------------------------------------------------- * driver entry points */