From: Eduardo Habkost Date: Thu, 10 Nov 2011 12:41:40 +0000 (-0200) Subject: QEMUFileCloseFunc: add return value documentation (v2) X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=90d8454ed0ffdec3871053b696e4a44f349e561c;p=qmiga%2Fqemu.git QEMUFileCloseFunc: add return value documentation (v2) qemu_fclose() and QEMUFile->close will return -errno on error, and any positive value on success. We need the positive non-zero success values because migration-exec.c:exec_close() relies on non-zero return values to get the process exit code. Changes v1 -> v2: - Cosmetic spelling change on comment text Signed-off-by: Eduardo Habkost Signed-off-by: Anthony Liguori --- diff --git a/hw/hw.h b/hw/hw.h index ed20f5a27a..efa04d1340 100644 --- a/hw/hw.h +++ b/hw/hw.h @@ -27,7 +27,13 @@ typedef int (QEMUFilePutBufferFunc)(void *opaque, const uint8_t *buf, typedef int (QEMUFileGetBufferFunc)(void *opaque, uint8_t *buf, int64_t pos, int size); -/* Close a file and return an error code */ +/* Close a file + * + * Return negative error number on error, 0 or positive value on success. + * + * The meaning of return value on success depends on the specific back-end being + * used. + */ typedef int (QEMUFileCloseFunc)(void *opaque); /* Called to determine if the file has exceeded it's bandwidth allocation. The