Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xdf_seek(3) [debian man page]

XDF_SEEK(3)						     xdffileio library manual						       XDF_SEEK(3)

NAME

       xdf_seek - move the sample pointer of a xDF file

SYNOPSIS

       #include <xdfio.h>

       off_t xdf_seek(struct xdf* xdf, off_t offset, int whence);

DESCRIPTION

       xdf_seek() repositions the current sample pointer according to the couple (offset,whence) where whence can be:

       SEEK_SET
	      The offset is set to offset bytes.

       SEEK_CUR
	      The offset is set to its current location plus offset bytes.

       SEEK_END
	      The offset is set to the size of the file plus offset bytes.

       The file referenced by xdf should have been opened with mode XDF_READ and xdf_prepare_arrays(3) should have been successfully called on it.

RETURN VALUE

       Upon  successful  completion,  xdf_seek()  returns the resulting offset location as measured in number of samples from the beginning of the
       recording. Otherwise, a value of -1 is returned and errno is set to indicate the error.

ERRORS

       EINVAL xdf is NULL or whence is none of the allowed values.

       EPERM  No successfull call to xdf_prepare_transfer(3) have been done on xdf or it has been opened using the mode XDF_WRITE.

       ERANGE The requested offset is out of the range of the recording.

       EINTR  The call was interrupted by a signal before any data was read; see signal(7).

       EIO    A low-level I/O error occurred while reading from the inode.

       ESTALE Stale file handle. This error can occur for NFS and for other file systems

SEE ALSO

       xdf_define_arrays(3), xdf_prepare_transfer(3)

EPFL
								       2010							       XDF_SEEK(3)

Check Out this Related Man Page

XDF_ADD_CHANNEL(3)					     xdffileio library manual						XDF_ADD_CHANNEL(3)

NAME

       xdf_add_channel - Appends a channel to a XDF file

SYNOPSIS

       #include <xdfio.h>

       struct xdfch* xdf_add_channel(struct xdf* xdf, const char* label);

DESCRIPTION

       xdf_add_channel()  appends  a  channel to the file referenced by the handle xdf. The new channel is initialized with the label argument (if
       not NULL) and with the default channel values set in the XDF file, i.e. those set using channel	configuration  fields  in  xdf_set_conf(3)
       (See the related manpage).

       If  the call to xdf_add_channel(3) is successful, the default offset value (the field referenced by XDF_CF_ARROFFSET) is incremented by the
       size of the current default stored type (field referenced by XDF_CF_STOTYPE). As a consequence, if the  channel	default  values  have  not
       changed in-between, the next call to xdf_add_channel() will create a channel whose location is the array will be next to the previous one.

       This type of initialization allows the user to add channels without having to specifically pack them: this is achieved by default.

RETURN VALUE

       xdf_add_channel()  returns  the handle to newly created channel descriptor in case of success. Otherwise NULL is returned  and errno is set
       appropriately.

ERRORS

       EINVAL xdf is NULL.

       ENOMEM The system is unable to allocate resources.

       EPERM  the file referenced by xdf has been opened with the mode XDF_READ

SEE ALSO

       xdf_copy_chconf(3), xdf_set_conf(3), xdf_set_chconf(3)

EPFL
								       2010							XDF_ADD_CHANNEL(3)
Man Page