[LinuxPPS] task force

[Udo van den Heuvel]

Udo van den Heuvel wrote:
> I can post the comments here before making a patch out of them.
> (saves me work)

Below are the functions from timepps.h.
Please comment on the descriptions.

Udo

timepps.h - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

/**
  * time_pps_create() - create pps source
  * @arg1:       source
  * @arg2:       handle
  *
  * Creates pps source from device passed in handle
  *
  **/

static __inline int time_pps_create(int source, pps_handle_t *handle)


/**
  * time_pps_destroy() - destroy pps source
  * @arg1:       handle
  *
  * Destroys pps source passed in handle
  *
  **/

static __inline int time_pps_destroy(pps_handle_t handle)


/**
  * time_pps_getparams() - get pps parameters
  * @arg1:       handle
  * @arg2:       ppsparams
  *
  * Gets pps parameters from device passed in handle
  *
  **/

static __inline int time_pps_getparams(pps_handle_t handle,
                                        pps_params_t *ppsparams)


/**
  * time_pps_setparams() - set pps parameters
  * @arg1:       handle
  * @arg2:       ppsparams
  *
  * Sets pps parameters to device passed in handle
  *
  **/

static __inline int time_pps_setparams(pps_handle_t handle,
                                        const pps_params_t *ppsparams)

/**
  * time_pps_getcap() - get pps capabilities
  * @arg1:       handle
  * @arg2:       mode
  *
  * Gets pps capabilities from device passed in handle
  *
  **/

static __inline int time_pps_getcap(pps_handle_t handle, int *mode)


/**
  * time_pps_fetch() - fetch pulse per second
  * @arg1:       handle
  * @arg2:       tsformat
  * @arg3:       ppsinfobuf
  * @arg4:       timeout
  *
  * Fetch pps timespec from device passed in handle
  *
  **/

static __inline int time_pps_fetch(pps_handle_t handle, const int tsformat,
                                        pps_info_t *ppsinfobuf,
                                        const struct timespec *timeout)

/**
  * time_pps_kcbind() - kernel consumer handling
  * @arg1:       handle
  * @arg2:       kernel_consumer
  * @arg3:       edge
  * @arg4:       tsformat
  *
  * Handles pps kernel consumer mode for device passed in handle
  * Currently LinuxPPS doesn't implement kernel consumer feature
  *
  **/

static __inline int time_pps_kcbind(pps_handle_t handle,
                                        const int kernel_consumer,
                                        const int edge, const int tsformat)