diff options
| author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2012-10-26 21:31:45 +0200 |
|---|---|---|
| committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2012-10-26 22:03:22 +0200 |
| commit | 9dffa384e1ce14ab110a30737051c4e8c98d7fc3 (patch) | |
| tree | b0e9c4143e20c18d5a4742700157eca6dd64636d /cpukit/libblock/include/rtems/bdbuf.h | |
| parent | libblock: ramdisk documentation (diff) | |
| download | rtems-9dffa384e1ce14ab110a30737051c4e8c98d7fc3.tar.bz2 | |
libblock: rtems_bdbuf_set_block_size() API change
The set block size must synchronize and purge the disk to avoid an
inconsistent cache state and data corruption. The synchronization is
optional depending on the new sync parameter. In some contexts a
synchronization must not be performed, e.g. during disk creation.
Diffstat (limited to 'cpukit/libblock/include/rtems/bdbuf.h')
| -rw-r--r-- | cpukit/libblock/include/rtems/bdbuf.h | 18 |
1 files changed, 14 insertions, 4 deletions
diff --git a/cpukit/libblock/include/rtems/bdbuf.h b/cpukit/libblock/include/rtems/bdbuf.h index 05e324c342..8a4631b9db 100644 --- a/cpukit/libblock/include/rtems/bdbuf.h +++ b/cpukit/libblock/include/rtems/bdbuf.h @@ -644,21 +644,31 @@ rtems_bdbuf_purge_dev (rtems_disk_device *dd); /** * @brief Sets the block size of a disk device. * - * This will set the block size derived fields of the disk device. The - * read-ahead state of this device is reset. + * This will set the block size derived fields of the disk device. If + * requested the disk device is synchronized before the block size change + * occurs. Since the cache is unlocked during the synchronization operation + * some tasks may access the disk device in the meantime. This may result in + * loss of data. After the synchronization the disk device is purged to ensure + * a consistent cache state and the block size change occurs. This also resets + * the read-ahead state of this disk device. Due to the purge operation this + * may result in loss of data. * * Before you can use this function, the rtems_bdbuf_init() routine must be * called at least once to initialize the cache, otherwise a fatal error will * occur. * * @param dd [in, out] The disk device. - * @param dd [in] The new block size. + * @param block_size [in] The new block size. + * @param sync [in] If @c true, then synchronize the disk device before the + * block size change. * * @retval RTEMS_SUCCESSFUL Successful operation. * @retval RTEMS_INVALID_NUMBER Invalid block size. */ rtems_status_code -rtems_bdbuf_set_block_size (rtems_disk_device *dd, uint32_t block_size); +rtems_bdbuf_set_block_size (rtems_disk_device *dd, + uint32_t block_size, + bool sync); /** * @brief Returns the block device statistics. |