staging: comedi: comedi_fops.c: reformat ioctl handler comments

}

/*

	COMEDI_DEVCONFIG

	device config ioctl

	arg:

		pointer to devconfig structure

	reads:

		devconfig structure at arg

	writes:

		none

 * COMEDI_DEVCONFIG ioctl

 * attaches (and configures) or detaches a legacy device

 *

 * arg:

 *	pointer to comedi_devconfig structure (NULL if detaching)

 *

 * reads:

 *	comedi_devconfig structure (if attaching)

 *

 * writes:

 *	nothing

 */

static int do_devconfig_ioctl(struct comedi_device *dev,

			      struct comedi_devconfig __user *arg)

}

/*

	COMEDI_BUFCONFIG

	buffer configuration ioctl

	arg:

		pointer to bufconfig structure

	reads:

		bufconfig at arg

	writes:

		modified bufconfig at arg

 * COMEDI_BUFCONFIG ioctl

 * buffer configuration

 *

 * arg:

 *	pointer to comedi_bufconfig structure

 *

 * reads:

 *	comedi_bufconfig structure

 *

 * writes:

 *	modified comedi_bufconfig structure

 */

static int do_bufconfig_ioctl(struct comedi_device *dev,

			      struct comedi_bufconfig __user *arg)

}

/*

	COMEDI_DEVINFO

	device info ioctl

	arg:

		pointer to devinfo structure

	reads:

		none

	writes:

		devinfo structure

 * COMEDI_DEVINFO ioctl

 * device info

 *

 * arg:

 *	pointer to comedi_devinfo structure

 *

 * reads:

 *	nothing

 *

 * writes:

 *	comedi_devinfo structure

 */

static int do_devinfo_ioctl(struct comedi_device *dev,

			    struct comedi_devinfo __user *arg,

}

/*

	COMEDI_SUBDINFO

	subdevice info ioctl

	arg:

		pointer to array of subdevice info structures

	reads:

		none

	writes:

		array of subdevice info structures at arg

 * COMEDI_SUBDINFO ioctl

 * subdevices info

 *

 * arg:

 *	pointer to array of comedi_subdinfo structures

 *

 * reads:

 *	nothing

 *

 * writes:

 *	array of comedi_subdinfo structures

 */

static int do_subdinfo_ioctl(struct comedi_device *dev,

			     struct comedi_subdinfo __user *arg, void *file)

}

/*

	COMEDI_CHANINFO

	subdevice info ioctl

	arg:

		pointer to chaninfo structure

	reads:

		chaninfo structure at arg

	writes:

		arrays at elements of chaninfo structure

 * COMEDI_CHANINFO ioctl

 * subdevice channel info

 *

 * arg:

 *	pointer to comedi_chaninfo structure

 *

 * reads:

 *	comedi_chaninfo structure

 *

 * writes:

 *	array of maxdata values to chaninfo->maxdata_list if requested

 *	array of range table lengths to chaninfo->range_table_list if requested

 */

static int do_chaninfo_ioctl(struct comedi_device *dev,

			     struct comedi_chaninfo __user *arg)

}

/*

    COMEDI_BUFINFO

    buffer information ioctl

    arg:

    pointer to bufinfo structure

    reads:

    bufinfo at arg

    writes:

    modified bufinfo at arg

 * COMEDI_BUFINFO ioctl

 * buffer information

 *

 * arg:

 *	pointer to comedi_bufinfo structure

 *

 * reads:

 *	comedi_bufinfo structure

 *

 * writes:

 *	modified comedi_bufinfo structure

 */

static int do_bufinfo_ioctl(struct comedi_device *dev,

			    struct comedi_bufinfo __user *arg, void *file)

}

/*

 *	COMEDI_INSNLIST

 *	synchronous instructions

 * COMEDI_INSNLIST ioctl

 * synchronous instruction list

 *

 * arg:

 *		pointer to sync cmd structure

 *	pointer to comedi_insnlist structure

 *

 * reads:

 *		sync cmd struct at arg

 *		instruction list

 *		data (for writes)

 *	comedi_insnlist structure

 *	array of comedi_insn structures from insnlist->insns pointer

 *	data (for writes) from insns[].data pointers

 *

 * writes:

 *		data (for reads)

 *	data (for reads) to insns[].data pointers

 */

/* arbitrary limits */

#define MAX_SAMPLES 256

}

/*

 *	COMEDI_INSN

 *	synchronous instructions

 * COMEDI_INSN ioctl

 * synchronous instruction

 *

 * arg:

 *		pointer to insn

 *	pointer to comedi_insn structure

 *

 * reads:

 *		struct comedi_insn struct at arg

 *		data (for writes)

 *	comedi_insn structure

 *	data (for writes) from insn->data pointer

 *

 * writes:

 *		data (for reads)

 *	data (for reads) to insn->data pointer

 */

static int do_insn_ioctl(struct comedi_device *dev,

			 struct comedi_insn __user *arg, void *file)

	return 0;

}

/*

 * COMEDI_CMD ioctl

 * asynchronous acquisition command set-up

 *

 * arg:

 *	pointer to comedi_cmd structure

 *

 * reads:

 *	comedi_cmd structure

 *	channel/range list from cmd->chanlist pointer

 *

 * writes:

 *	possibly modified comedi_cmd structure (when -EAGAIN returned)

 */

static int do_cmd_ioctl(struct comedi_device *dev,

			struct comedi_cmd __user *arg, void *file)

{

}

/*

	COMEDI_CMDTEST

	command testing ioctl

	arg:

		pointer to cmd structure

	reads:

		cmd structure at arg

		channel/range list

	writes:

		modified cmd structure at arg

 * COMEDI_CMDTEST ioctl

 * asynchronous aquisition command testing

 *

 * arg:

 *	pointer to comedi_cmd structure

 *

 * reads:

 *	comedi_cmd structure

 *	channel/range list from cmd->chanlist pointer

 *

 * writes:

 *	possibly modified comedi_cmd structure

 */

static int do_cmdtest_ioctl(struct comedi_device *dev,

			    struct comedi_cmd __user *arg, void *file)

}

/*

	COMEDI_LOCK

	lock subdevice

	arg:

		subdevice number

	reads:

		none

	writes:

		none

 * COMEDI_LOCK ioctl

 * lock subdevice

 *

 * arg:

 *	subdevice number

 *

 * reads:

 *	nothing

 *

 * writes:

 *	nothing

 */

static int do_lock_ioctl(struct comedi_device *dev, unsigned long arg,

			 void *file)

{

}

/*

	COMEDI_UNLOCK

	unlock subdevice

	arg:

		subdevice number

	reads:

		none

	writes:

		none

	This function isn't protected by the semaphore, since

	we already own the lock.

 * COMEDI_UNLOCK ioctl

 * unlock subdevice

 *

 * arg:

 *	subdevice number

 *

 * reads:

 *	nothing

 *

 * writes:

 *	nothing

 */

static int do_unlock_ioctl(struct comedi_device *dev, unsigned long arg,

			   void *file)

}

/*

	COMEDI_CANCEL

	cancel acquisition ioctl

	arg:

		subdevice number

	reads:

		nothing

	writes:

		nothing

 * COMEDI_CANCEL ioctl

 * cancel asynchronous acquisition

 *

 * arg:

 *	subdevice number

 *

 * reads:

 *	nothing

 *

 * writes:

 *	nothing

 */

static int do_cancel_ioctl(struct comedi_device *dev, unsigned long arg,

			   void *file)

}

/*

	COMEDI_POLL ioctl

	instructs driver to synchronize buffers

	arg:

		subdevice number

	reads:

		nothing

	writes:

		nothing

 * COMEDI_POLL ioctl

 * instructs driver to synchronize buffers

 *

 * arg:

 *	subdevice number

 *

 * reads:

 *	nothing

 *

 * writes:

 *	nothing

 */

static int do_poll_ioctl(struct comedi_device *dev, unsigned long arg,

			 void *file)