yubihsm_usb.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	YH_INTERNAL   __attribute__((visibility("hidden")))

Functions
void YH_INTERNAL	usb_close (yh_backend *state)
void YH_INTERNAL	usb_destroy (yh_backend **state)
yh_backend YH_INTERNAL *	backend_create (void)
bool YH_INTERNAL	usb_open_device (yh_backend *backend)
int YH_INTERNAL	usb_write (yh_backend *state, unsigned char *buf, long unsigned len)
int YH_INTERNAL	usb_read (yh_backend *state, unsigned char *buf, long unsigned *len)
void YH_INTERNAL	usb_set_serial (yh_backend *state, unsigned long serial)

Macro Definition Documentation

YH_INTERNAL

#define YH_INTERNAL   __attribute__((visibility("hidden")))

Definition at line 21 of file yubihsm_usb.h.

Function Documentation

backend_create()

yh_backend YH_INTERNAL * backend_create

(

void

)

Definition at line 60 of file yubihsm_libusb.c.

                                 {
  yh_backend *backend = calloc(1, sizeof(yh_backend));
  if (backend) {
    libusb_init(&backend->ctx);
  }
  return backend;
}

usb_close()

void YH_INTERNAL usb_close

(

yh_backend *

state

)

Definition at line 40 of file yubihsm_libusb.c.

                                  {
  if (state && state->handle) {
    libusb_release_interface(state->handle, 0);
    libusb_close(state->handle);
    state->handle = NULL;
  }
}

Here is the caller graph for this function:

usb_destroy()

void YH_INTERNAL usb_destroy

(

yh_backend **

state

)

Definition at line 48 of file yubihsm_libusb.c.

                                     {
  if (state && *state) {
    usb_close(*state);
    if ((*state)->ctx) {
      libusb_exit((*state)->ctx);
      (*state)->ctx = NULL;
    }
    free(*state);
    *state = NULL;
  }
}

Here is the call graph for this function:

usb_open_device()

bool YH_INTERNAL usb_open_device

(

yh_backend *

backend

)

Definition at line 68 of file yubihsm_libusb.c.

                                          {
  libusb_device **list;
  libusb_device_handle *h = NULL;
  ssize_t cnt = libusb_get_device_list(backend->ctx, &list);
 
  if (backend->handle) {
    usb_close(backend);
  }
 
  if (cnt < 0) {
    DBG_ERR("Failed to get device list: %s", libusb_strerror(cnt));
    return NULL;
  }
 
  for (ssize_t i = 0; i < cnt; i++) {
    struct libusb_device_descriptor desc;
    int ret = libusb_get_device_descriptor(list[i], &desc);
    if (ret != 0) {
      DBG_INFO("Failed to get descriptor for device %zd: %s", i,
               libusb_strerror(ret));
      continue;
    }
    if (desc.idVendor == YH_VID && desc.idProduct == YH_PID) {
      ret = libusb_open(list[i], &h);
      if (ret != 0 || h == NULL) {
        DBG_INFO("Failed to open device for index %zd: %s", i,
                 libusb_strerror(ret));
        continue;
      }
      if (backend->serial != 0) {
        unsigned char data[16] = {0};
 
        ret = libusb_get_string_descriptor_ascii(h, desc.iSerialNumber, data,
                                                 sizeof(data));
 
        unsigned long devSerial = strtoul((char *) data, NULL, 10);
 
        if (devSerial != backend->serial) {
          DBG_INFO("Device %zd has serial %lu, not matching searched %lu", i,
                   devSerial, backend->serial);
          goto next;
        }
      }
 
      ret = libusb_claim_interface(h, 0);
      if (ret != 0) {
        DBG_ERR("Failed to claim interface: %s of device %zd",
                libusb_strerror(ret), i);
        goto next;
      }
 
      break;
    next:
      libusb_close(h);
      h = NULL;
    }
  }
 
  libusb_free_device_list(list, 1);
  backend->handle = h;
  if (h) {
    // we set up a dummy read with a 1ms timeout here. The reason for doing this
    // is that there might be data left in th e device buffers from earlier
    // transactions, this should flush it.
    unsigned char buf[YH_MSG_BUF_SIZE];
    int transferred = 0;
    if (libusb_bulk_transfer(h, 0x81, buf, sizeof(buf), &transferred, 1) == 0) {
      DBG_INFO("%d bytes of stale data read from device", transferred);
    }
    return true;
  } else {
    return false;
  }
}

Here is the call graph for this function:

usb_read()

int YH_INTERNAL usb_read	(	yh_backend *	state,
		unsigned char *	buf,
		long unsigned *	len )

Definition at line 302 of file yubihsm_winusb.c.

                                                                        {
  long unsigned transferred = 0;
  BOOL bResult;
 
  if (state->hWinUSB == INVALID_HANDLE_VALUE) {
    DBG_ERR("No connected device");
    return 0;
  }
 
  DBG_INFO("Doing usb read");
 
  bResult =
    WinUsb_ReadPipe(state->hWinUSB, PIPE_IN, buf, *len, &transferred, 0);
  if (!bResult) {
    DBG_ERR("WinUsb_ReadPipe failed, error=%lx\n", GetLastError());
    return 0;
  }
  DBG_INFO("Read %lu bytes", transferred);
  *len = transferred;
  return 1;
}

usb_set_serial()

void YH_INTERNAL usb_set_serial	(	yh_backend *	state,
		unsigned long	serial )

Definition at line 36 of file yubihsm_libusb.c.

                                                             {
  state->serial = serial;
}

usb_write()

int YH_INTERNAL usb_write	(	yh_backend *	state,
		unsigned char *	buf,
		long unsigned	len )

Definition at line 143 of file yubihsm_libusb.c.

                                                                        {
  int transferred = 0;
  if (state->handle == NULL) {
    DBG_ERR("Handle is not connected");
    return 0;
  }
  /* TODO: does this need to loop and transmit several times? */
  int ret =
    libusb_bulk_transfer(state->handle, 0x01, buf, len, &transferred, 0);
  DBG_INFO("Write of %lu %d, err %d", len, transferred, ret);
  if (ret != 0 || transferred != (int) len) {
    DBG_ERR("Transferred did not match len of write %d-%lu", transferred, len);
    return 0;
  }
  if (len % 64 == 0) {
    /* this writes the ZLP */
    ret = libusb_bulk_transfer(state->handle, 0x01, buf, 0, &transferred, 0);
    if (ret != 0) {
      return 0;
    }
  }
  return 1;
}