GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


NAME

       xdf_prepare_transfer  - Setup the internals of the xDF file to be ready
       to receive or send data.

SYNOPSIS

       #include <xdfio.h>

       int xdf_prepare_transfer(struct xdf* xdf);

DESCRIPTION

       xdf_prepare_transfer() set up the internal structures of the  xDF  file
       referenced  by  xdf  to  be  ready  to  receive  or  send data. After a
       successful call  to  it,  you  can  call  xdf_write(3)  or  xdf_read(3)
       depending of the mode of the xDF file.

       Since  this  function  prepares  the  transfer, no call to any function
       which configures it will be allowed anymore after  xdf_define_arrays(3)
       succeed.   In   particular,   xdf_set_conf(3),   xdf_setchconf(3)   and
       xdf_define_arrays(3) will fail afterwards.

       In case of failure due to I/O (file to big, connection to  file  system
       lost...),  the best procedure is to close the file since the underlying
       file will be in a undertermined stated.

RETURN VALUE

       xdf_define_arrays() returns 0 in  case  of  success.  Otherwise  -1  is
       returned and errno is set appropriately.

ERRORS

       EINVAL xdf is NULL.

       ENOMEM The system is unable to allocate memory resources.

       EFBIG  An   attempt   was  made  to  write  a  file  that  exceeds  the
              implementation-defined maximum file size or the  process's  file
              size  limit,  or to write at a position past the maximum allowed
              offset.

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

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

       ENOSPC The device containing the xDF file has no room for the data.

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

SEE ALSO

       xdf_define_arrays(3), xdf_set_conf(3), xdf_set_chconf(3),  xdf_read(3),
       xdf_write(3)



  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to webmaster@gnu.wiki.
Page load time: 0.110 seconds. Last modified: November 04 2018 12:49:43.