storage: FS: Tweak some comments and fix typos

This commit is contained in:
Peter Krempa 2014-01-10 11:51:04 +01:00
parent c91d13bd0f
commit fbe472d583

View File

@ -1,7 +1,7 @@
/* /*
* storage_backend_fs.c: storage backend for FS and directory handling * storage_backend_fs.c: storage backend for FS and directory handling
* *
* Copyright (C) 2007-2013 Red Hat, Inc. * Copyright (C) 2007-2014 Red Hat, Inc.
* Copyright (C) 2007-2008 Daniel P. Berrange * Copyright (C) 2007-2008 Daniel P. Berrange
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
@ -460,7 +460,7 @@ cleanup:
* @pool storage pool to unmount * @pool storage pool to unmount
* *
* Ensure that a FS storage pool is not mounted on its target location. * Ensure that a FS storage pool is not mounted on its target location.
* If already unmounted, this is a no-op * If already unmounted, this is a no-op.
* *
* Returns 0 if successfully unmounted, -1 on error * Returns 0 if successfully unmounted, -1 on error
*/ */
@ -540,9 +540,8 @@ virStorageBackendFileSystemCheck(virConnectPtr conn ATTRIBUTE_UNUSED,
* @conn connection to report errors against * @conn connection to report errors against
* @pool storage pool to start * @pool storage pool to start
* *
* Starts a directory or FS based storage pool. * Starts a directory or FS based storage pool. The underlying source
* * device will be mounted for FS based pools.
* - If it is a FS based pool, mounts the unlying source device on the pool
* *
* Returns 0 on success, -1 on error * Returns 0 on success, -1 on error
*/ */
@ -739,7 +738,7 @@ error:
* VIR_STORAGE_POOL_BUILD_OVERWRITE is set, mkfs is always executed, * VIR_STORAGE_POOL_BUILD_OVERWRITE is set, mkfs is always executed,
* any existed data on the target device is overwritten unconditionally. * any existed data on the target device is overwritten unconditionally.
* *
* - If it is a FS based pool, mounts the unlying source device on the pool * The underlying source device is mounted for FS based pools.
* *
* Returns 0 on success, -1 on error * Returns 0 on success, -1 on error
*/ */
@ -940,12 +939,12 @@ virStorageBackendFileSystemRefresh(virConnectPtr conn ATTRIBUTE_UNUSED,
/** /**
* @conn connection to report errors against * @conn connection to report errors against
* @pool storage pool to start * @pool storage pool to stop
* *
* Stops a FS based storage pool. * Stops a file storage pool. The underlying source device is unmounted
* for FS based pools. Any cached data about volumes is released.
* *
* - If it is a FS based pool, unmounts the unlying source device on the pool * Returns 0 on success, -1 on error.
* - Releases all cached data about volumes
*/ */
#if WITH_STORAGE_FS #if WITH_STORAGE_FS
static int static int