From 5ea14dfbe54671147ee2158698f03e4c661efea7 Mon Sep 17 00:00:00 2001 From: Bart Van Assche Date: Mon, 13 Dec 2010 13:31:57 +0000 Subject: [PATCH] Rewrote two comments blocks. git-svn-id: http://svn.code.sf.net/p/scst/svn/trunk@3045 d57e44dd-8a1f-0410-8b47-8ef2f437770f --- scst/src/scst_main.c | 19 ++++++------------- 1 file changed, 6 insertions(+), 13 deletions(-) diff --git a/scst/src/scst_main.c b/scst/src/scst_main.c index 30cbea073..6558bb5c3 100644 --- a/scst/src/scst_main.c +++ b/scst/src/scst_main.c @@ -686,17 +686,12 @@ static int scst_susp_wait(bool interruptible) } /** - * scst_suspend_activity() - globally suspend any activity + * scst_suspend_activity() - Globally suspend SCSI command processing. * - * Description: - * Globally suspends any activity and doesn't return, until there are any - * active commands (state after SCST_CMD_STATE_INIT). If "interruptible" - * is true, it returns after SCST_SUSPENDING_TIMEOUT or if it was interrupted - * by a signal with the corresponding error status < 0. If "interruptible" - * is false, it will wait virtually forever. On success returns 0. - * - * New arriving commands stay in the suspended state until - * scst_resume_activity() is called. + * Wait until any ongoing SCSI commands have finished and suspend processing + * of new SCSI commands. If the argument "interruptible" is set to true, + * returns after either SCST_SUSPENDING_TIMEOUT elapsed or if interrupted by a + * signal. Returns zero upon success or a negative error code upon failure. */ int scst_suspend_activity(bool interruptible) { @@ -838,9 +833,7 @@ out: } /** - * scst_resume_activity() - globally resume all activities - * - * Resumes suspended by scst_suspend_activity() activities. + * scst_resume_activity() - Globally resume SCSI command processing. */ void scst_resume_activity(void) {