virt: vbox: core: fix all kernel-doc warnings

	 VMMDEV_REQUESTOR_CON_DONT_KNOW | VMMDEV_REQUESTOR_TRUST_NOT_GIVEN)

/**

 * Reserves memory in which the VMM can relocate any guest mappings

 * that are floating around.

 * vbg_guest_mappings_init - Reserves memory in which the VMM can

 *	relocate any guest mappings that are floating around.

 * @gdev:		The Guest extension device.

 *

 * This operation is a little bit tricky since the VMM might not accept

 * just any address because of address clashes between the three contexts

 * it operates in, so we try several times.

 *

 * Failure to reserve the guest mappings is ignored.

 *

 * @gdev:		The Guest extension device.

 */

static void vbg_guest_mappings_init(struct vbg_dev *gdev)

{

}

/**

 * Undo what vbg_guest_mappings_init did.

 * vbg_guest_mappings_exit - Undo what vbg_guest_mappings_init did.

 *

 * @gdev:		The Guest extension device.

 */

}

/**

 * Report the guest information to the host.

 * Return: 0 or negative errno value.

 * vbg_report_guest_info - Report the guest information to the host.

 * @gdev:		The Guest extension device.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_report_guest_info(struct vbg_dev *gdev)

{

}

/**

 * Report the guest driver status to the host.

 * Return: 0 or negative errno value.

 * vbg_report_driver_status - Report the guest driver status to the host.

 * @gdev:		The Guest extension device.

 * @active:		Flag whether the driver is now active or not.

 *

 * Return: 0 or negative errno value.

 */

static int vbg_report_driver_status(struct vbg_dev *gdev, bool active)

{

}

/**

 * Inflate the balloon by one chunk. The caller owns the balloon mutex.

 * Return: 0 or negative errno value.

 * vbg_balloon_inflate - Inflate the balloon by one chunk. The caller

 * owns the balloon mutex.

 * @gdev:		The Guest extension device.

 * @chunk_idx:		Index of the chunk.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_balloon_inflate(struct vbg_dev *gdev, u32 chunk_idx)

{

}

/**

 * Deflate the balloon by one chunk. The caller owns the balloon mutex.

 * Return: 0 or negative errno value.

 * vbg_balloon_deflate - Deflate the balloon by one chunk. The caller

 * owns the balloon mutex.

 * @gdev:		The Guest extension device.

 * @chunk_idx:		Index of the chunk.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_balloon_deflate(struct vbg_dev *gdev, u32 chunk_idx)

{

	return 0;

}

/**

/*

 * Respond to VMMDEV_EVENT_BALLOON_CHANGE_REQUEST events, query the size

 * the host wants the balloon to be and adjust accordingly.

 */

	}

}

/**

/*

 * Callback for heartbeat timer.

 */

static void vbg_heartbeat_timer(struct timer_list *t)

}

/**

 * Configure the host to check guest's heartbeat

 * vbg_heartbeat_host_config - Configure the host to check guest's heartbeat

 *	and get heartbeat interval from the host.

 * Return: 0 or negative errno value.

 * @gdev:		The Guest extension device.

 * @enabled:		Set true to enable guest heartbeat checks on host.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_heartbeat_host_config(struct vbg_dev *gdev, bool enabled)

{

}

/**

 * Initializes the heartbeat timer. This feature may be disabled by the host.

 * Return: 0 or negative errno value.

 * vbg_heartbeat_init - Initializes the heartbeat timer. This feature

 * may be disabled by the host.

 * @gdev:		The Guest extension device.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_heartbeat_init(struct vbg_dev *gdev)

{

}

/**

 * Cleanup hearbeat code, stop HB timer and disable host heartbeat checking.

 * vbg_heartbeat_exit - Cleanup heartbeat code, stop HB timer and disable

 *	host heartbeat checking.

 * @gdev:		The Guest extension device.

 */

static void vbg_heartbeat_exit(struct vbg_dev *gdev)

}

/**

 * Applies a change to the bit usage tracker.

 * Return: true if the mask changed, false if not.

 * vbg_track_bit_usage - Applies a change to the bit usage tracker.

 * @tracker:		The bit usage tracker.

 * @changed:		The bits to change.

 * @previous:		The previous value of the bits.

 *

 * Return: %true if the mask changed, %false if not.

 */

static bool vbg_track_bit_usage(struct vbg_bit_usage_tracker *tracker,

				u32 changed, u32 previous)

}

/**

 * Init and termination worker for resetting the (host) event filter on the host

 * Return: 0 or negative errno value.

 * vbg_reset_host_event_filter - Init and termination worker for

 *	resetting the (host) event filter on the host

 * @gdev:		   The Guest extension device.

 * @fixed_events:	   Fixed events (init time).

 *

 * Return: %0 or negative errno value.

 */

static int vbg_reset_host_event_filter(struct vbg_dev *gdev,

				       u32 fixed_events)

}

/**

 * Changes the event filter mask for the given session.

 *

 * This is called in response to VBG_IOCTL_CHANGE_FILTER_MASK as well as to

 * do session cleanup. Takes the session mutex.

 *

 * Return: 0 or negative errno value.

 * vbg_set_session_event_filter - Changes the event filter mask for the

 *	given session.

 * @gdev:			The Guest extension device.

 * @session:			The session.

 * @or_mask:			The events to add.

 *				This tweaks the error handling so we perform

 *				proper session cleanup even if the host

 *				misbehaves.

 *

 * This is called in response to VBG_IOCTL_CHANGE_FILTER_MASK as well as to

 * do session cleanup. Takes the session mutex.

 *

 * Return: 0 or negative errno value.

 */

static int vbg_set_session_event_filter(struct vbg_dev *gdev,

					struct vbg_session *session,

}

/**

 * Init and termination worker for set guest capabilities to zero on the host.

 * Return: 0 or negative errno value.

 * vbg_reset_host_capabilities - Init and termination worker for set

 *	guest capabilities to zero on the host.

 * @gdev:		The Guest extension device.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_reset_host_capabilities(struct vbg_dev *gdev)

{

}

/**

 * Set guest capabilities on the host.

 * Must be called with gdev->session_mutex hold.

 * Return: 0 or negative errno value.

 * vbg_set_host_capabilities - Set guest capabilities on the host.

 * @gdev:			The Guest extension device.

 * @session:			The session.

 * @session_termination:	Set if we're called by the session cleanup code.

 *

 * Must be called with gdev->session_mutex hold.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_set_host_capabilities(struct vbg_dev *gdev,

				     struct vbg_session *session,

}

/**

 * Acquire (get exclusive access) guest capabilities for a session.

 * Takes the session mutex.

 * Return: 0 or negative errno value.

 * vbg_acquire_session_capabilities - Acquire (get exclusive access)

 *	guest capabilities for a session.

 * @gdev:			The Guest extension device.

 * @session:			The session.

 * @flags:			Flags (VBGL_IOC_AGC_FLAGS_XXX).

 *				This tweaks the error handling so we perform

 *				proper session cleanup even if the host

 *				misbehaves.

 *

 * Takes the session mutex.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_acquire_session_capabilities(struct vbg_dev *gdev,

					    struct vbg_session *session,

}

/**

 * Sets the guest capabilities for a session. Takes the session mutex.

 * Return: 0 or negative errno value.

 * vbg_set_session_capabilities - Sets the guest capabilities for a

 *	session. Takes the session mutex.

 * @gdev:			The Guest extension device.

 * @session:			The session.

 * @or_mask:			The capabilities to add.

 *				This tweaks the error handling so we perform

 *				proper session cleanup even if the host

 *				misbehaves.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_set_session_capabilities(struct vbg_dev *gdev,

					struct vbg_session *session,

}

/**

 * vbg_query_host_version get the host feature mask and version information.

 * Return: 0 or negative errno value.

 * vbg_query_host_version - get the host feature mask and version information.

 * @gdev:		The Guest extension device.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_query_host_version(struct vbg_dev *gdev)

{

}

/**

 * Initializes the VBoxGuest device extension when the

 * vbg_core_init - Initializes the VBoxGuest device extension when the

 *	device driver is loaded.

 * @gdev:		The Guest extension device.

 * @fixed_events:	Events that will be enabled upon init and no client

 *			will ever be allowed to mask.

 *

 * The native code locates the VMMDev on the PCI bus and retrieve

 * the MMIO and I/O port ranges, this function will take care of

 * mapping the MMIO memory (if present). Upon successful return

 * the native code should set up the interrupt handler.

 *

 * Return: 0 or negative errno value.

 *

 * @gdev:		The Guest extension device.

 * @fixed_events:	Events that will be enabled upon init and no client

 *			will ever be allowed to mask.

 * Return: %0 or negative errno value.

 */

int vbg_core_init(struct vbg_dev *gdev, u32 fixed_events)

{

}

/**

 * Call this on exit to clean-up vboxguest-core managed resources.

 * vbg_core_exit - Call this on exit to clean-up vboxguest-core managed

 *	resources.

 * @gdev:		The Guest extension device.

 *

 * The native code should call this before the driver is loaded,

 * but don't call this on shutdown.

 * @gdev:		The Guest extension device.

 */

void vbg_core_exit(struct vbg_dev *gdev)

{

}

/**

 * Creates a VBoxGuest user session.

 * vbg_core_open_session - Creates a VBoxGuest user session.

 * @gdev:		The Guest extension device.

 * @requestor:		VMMDEV_REQUESTOR_* flags

 *

 * vboxguest_linux.c calls this when userspace opens the char-device.

 *

 * Return: A pointer to the new session or an ERR_PTR on error.

 * @gdev:		The Guest extension device.

 * @requestor:		VMMDEV_REQUESTOR_* flags

 */

struct vbg_session *vbg_core_open_session(struct vbg_dev *gdev, u32 requestor)

{

}

/**

 * Closes a VBoxGuest session.

 * vbg_core_close_session - Closes a VBoxGuest session.

 * @session:		The session to close (and free).

 */

void vbg_core_close_session(struct vbg_session *session)

}

/**

 * Checks if the VMM request is allowed in the context of the given session.

 * Return: 0 or negative errno value.

 * vbg_req_allowed - Checks if the VMM request is allowed in the

 *	context of the given session.

 * @gdev:		The Guest extension device.

 * @session:		The calling session.

 * @req:		The request.

 *

 * Return: %0 or negative errno value.

 */

static int vbg_req_allowed(struct vbg_dev *gdev, struct vbg_session *session,

			   const struct vmmdev_request_header *req)

}

/**

 * Common IOCtl for user to kernel communication.

 * Return: 0 or negative errno value.

 * vbg_core_ioctl - Common IOCtl for user to kernel communication.

 * @session:	The client session.

 * @req:	The requested function.

 * @data:	The i/o data buffer, minimum size sizeof(struct vbg_ioctl_hdr).

 *

 * Return: %0 or negative errno value.

 */

int vbg_core_ioctl(struct vbg_session *session, unsigned int req, void *data)

{

}

/**

 * Report guest supported mouse-features to the host.

 * vbg_core_set_mouse_status - Report guest supported mouse-features to the host.

 *

 * Return: 0 or negative errno value.

 * @gdev:		The Guest extension device.

 * @features:		The set of features to report to the host.

 *

 * Return: %0 or negative errno value.

 */

int vbg_core_set_mouse_status(struct vbg_dev *gdev, u32 features)

{

	return vbg_status_code_to_errno(rc);

}

/** Core interrupt service routine. */

/* Core interrupt service routine. */

irqreturn_t vbg_core_isr(int irq, void *dev_id)

{

	struct vbg_dev *gdev = dev_id;