Is called to demigrate files.
#include <zMigrate.h> STATUS (*demigrateFunction) ( key_t key, QUAD offset, QUAD length);
(IN) Specifies that read/write access is to be granted to the migrated file. This parameter can be used to write back to the file the data that has been migrated.
(IN) Specifies the offset in the file where the user is starting to access the file. This parameter helps determine the minimum amount of data that must be migrated. However, the user can choose to migrate more data.
(IN) Specifies the length of the data that must be demigrated, starting from the offset parameter.
|
zOK |
The operation completed successfully. |
|
zERR_DEMIGRATE_ ALREADY_REGISTERED |
A demigration function has been registered. Only one demigrator can reside in the system at a time. |
When you request that NSS access the data portion of a migrated file, NSS calls this demigration function. After this demigration function returns, NSS expects the data to be demigrated and begins accessing the data.
To demigrate a file, call zWrite to write the demigrated data back to the data stream. After this demigrated function returns, the key parameter is cleaned up.