op_sim_file_register_fopen()
Abstract
Registers an open file (by file pointer) with the simulation’s checkpoint registry.
Syntax
op_sim_file_register_fopen (fptr, file_name)
| Argument | Type | Description |
|---|---|---|
fptr |
FILE * |
File to register. |
file_name |
const char * |
Full-path file name. |
Return Type
void
No return value.
Example
FILE * file_ptr = fopen ("/some/path", "r");
op_sim_file_register_fopen (file_ptr, "/some/path");
Details
When using checkpoints, simulations keep track of which files have been opened via Riverbed APIs so that those files can be reopened when the simulation is restarted. If your code opens files directly (for example, using C calls), it must also register those files so that they can be reopened upon restart.
If you don’t have a file pointer, use op_sim_file_register_open() to register the file using a file descriptor.
Purpose
Provides a mechanism to register directly opened files so that they can be reopened by a checkpoint restart.
Errors
- No errors are trapped.
Reference
- None