-/* bf_read: reads bytes from bfile 'bf'.
- reads 'nbytes' bytes (or whole block if 0) from offset 'offset' from
- block 'no'. stores contents in buffer 'buf'.
- returns 1 if whole block could be read; 0 otherwise.
+/** \brief opens and returns an extended Block file handle
+ \param bfs block files
+ \param name filename
+ \param block_size block size in bytes
+ \param wflag 1=opened for read&write, 0=read only
+ \param magic magic string to be used for file
+ \param read_version holds after completion of bf_xopen the version
+ \param more_info holds more_info as read from file (header)
+*/
+YAZ_EXPORT
+BFile bf_xopen(BFiles bfs, const char *name, int block_size, int wflag,
+ const char *magic, int *read_version,
+ const char **more_info);
+
+/** \brief read from block file
+ \param bf block file handle
+ \param no block no (first block is 0, second is 1..)
+ \param offset offset within block to be read
+ \param nbytes number of bytes to read (0 for whole block)
+ \param buf raw bytes with content (at least nbytes of size)
+
+ Returns 1 if whole block could be read; 0 otherwise.