wyfifofile.3wy

一个不错

.\"
.\" Edited by I.J.Wang, 2004
.\"
.TH WyFifoFile 3wy "libwy v0.31"
.SH NAME
WyFifoFile \- handle class for system FIFO file
.SH SYNOPSIS
.B #include <wyfifofile.h>
.PP
[\fBInherit\fP] WyByteFlow
.PP
WyFifoFile is a handle class for the system FIFO file.

Pipe is created by the static function \fBmkpipe\fP.
.SH "PUBLIC MEMBERS"
 class \fBReply\fP : public WyRet
 \fBWyFifoFile\fP()
 \fBWyFifoFile\fP(WyFileHandle)
 \fBWyFifoFile\fP(const WySysFile&)
 \fBWyFifoFile\fP(const char*,int)
 \fBWyFifoFile\fP(const WyStr&,int)
 \fBWyFifoFile\fP(const WyFifoFile&)
 \fBWyFifoFile\fP(WyFifoFile&, Wy::ByMove_t) throw()
 virtual \fB~WyFifoFile\fP()
 bool \fBis_default\fP(void) const throw()
 WyFileHandle \fBfh\fP(void) const throw()
 WyRet \fBstat\fP(WyFileStat&) const
 virtual WyRet \fBreset\fP(void)
 virtual WyRet \fBreset\fP(WyFileHandle)
 virtual WyRet \fBreset\fP(const WySysFile&)
 virtual WyRet \fBreset\fP(const char*,int)
 virtual WyRet \fBreset\fP(const WyStr&,int)
 virtual WyRet \fB_swap\fP(WySysFile&) throw()
 virtual WyFifoFile* \fB_alloc\fP(WyRet&) const
 virtual WyRet \fBread\fP(void*,size_t,size_t&)
 virtual WyRet \fBread\fP(WyStr&,size_t,size_t&)
 virtual WyRet \fBwrite\fP(const void*,size_t,size_t&)
 virtual WyRet \fBwrite\fP(WyCSeg,size_t&)
 virtual WyRet \fBwrite\fP(const WyStr&,size_t&)

 static WyRet \fBmkpipe\fP(WyFifoFile&,WyFifoFile&)
 static WyRet \fBcreate\fP(const char*,mode_t)
 static WyRet \fBcreate\fP(const WyStr&,mode_t)
.SH "DESCRIPTION"
.\"--------------------------------------------
.PP
.BI "class Reply : public WyRet
.PP
    Class specific throw type. 
.\"--------------------------------------------
.PP
.BI "WyFifoFile()"
.PP
    Construct default object (refers to nothing)

     fh()= WyFileHandle()
.PP
    [\fBThrow\fP] Reply
            (reserved)
.\"--------------------------------------------
.PP
.BI "WyFifoFile(WyFileHandle " "h" ")" 
.PP
    Construct object to handle the system file handled by \fIh\fP

     fh()= Contains file descriptor ::dup from \fIh\fP
.PP
    [\fBThrow\fP] Reply
            Wym_EBADF       \fIh\fP is not valid for the operation
            Wym_EINTR       Interrupted by a signal
            Wym_EMFILE      Too many open fd
.PP 
    [\fBRefer\fP] ::dup(int)
.\"--------------------------------------------
.PP
.BI "WyFifoFile(const WySysFile& " "ff" ")"
.PP
    Construct object to handle the system file handled by \fIff\fP

     fh()= Contains file descriptor ::dup from \fIff\fP
.PP
    [\fBThrow\fP] Reply
            Wym_EBADF   \fIff\fP is not valid for the operation
            Wym_EMFILE  Too many open devices
            Wym_ENOMEM  Not enough memory
.PP 
    [\fBRefer\fP] ::dup(int)
.\"--------------------------------------------
.PP
.BI "WyFifoFile(const char* " "pathname" ",int " "f" ")" 
.PP
.BI "WyFifoFile(const WyStr& " "pathname" ",int " "f" ")" 
.PP
    Construct object to handle the system file pointed by
    \fIpathname\fP with flags \fIf\fP.

        \fIf\fP= flags for ::open, except O_CREAT

     fh()= Contains file descriptor from ::open(\fIpathname\fP,\fIf\fP)

    Note: Opening a FIFO may block, see fifo(4)
.PP
    [\fBThrow\fP] Reply
            Wym_EACCES      Search permission is denied
            Wym_EBADF       File is not valid for the operation
            Wym_EINVAL      \fIf\fP invalid
            Wym_ENAMETOOLONG \fIpathname\fP too long
            Wym_ENOENT      \fIpathname\fP does not exist
            Wym_ENOTDIR     Entry in \fIpathname\fP is not a directory
            Wym_EMFILE      Too many open fd
            Wym_ENFILE      File table overflow
            Wym_ENOMEM      Not enough memory
            Wym_EEXIST      Pathname already exists
            Wym_EINTR       Interrupted by a signal
            Wym_ENOSPC      Device left no space for the operation
            Wym_ENXIO       No such device (device not ready)
            Wym_EROFS       Read-only file system
            Wym_ENODEV      No such device
            Wym_ELOOP       Too many symbolic links encountered
            ...             reply converted from ::open
.PP 
    [\fBRefer\fP] ::open(const char*,int)
.\"--------------------------------------------
.PP
.BI "WyFifoFile(const WyFifoFile& " "ff" ")"
.PP
    Construct object to handle the system file handled by \fIff\fP

     fh()= Contains file descriptor ::dup from \fIff\fP
.PP
    [\fBThrow\fP] Reply
            Wym_EMFILE  Too many open devices
            Wym_ENOMEM  Not enough memory
.PP 
    [\fBRefer\fP] ::dup(int)
.\"--------------------------------------------
.PP
.BI "WyFifoFile(WyFifoFile& " "src" ", Wy::ByMove_t) throw()"
.PP
    See Wy_Array(Wy_Array&, Wy::ByMove_t) in wy_array(3wy)
    for definition of the move constructor.
.\"--------------------------------------------
.PP
.BI "virtual ~WyFifoFile()"
.PP
    Destruct *this
.PP
    Note: errno from ::close(int) is ignored.

    Note: This member is non-cancellable.
.PP 
    [\fBRefer\fP] ::close(int)
.\"--------------------------------------------
.PP
.BI "bool is_default(void) const throw()"
.TP
    Is *this equivalent to the default object
.PP
    [\fBRet\fP] true= object is equivalent to WyFifoFile().
         false= otherwise
.\"--------------------------------------------
.PP
.BI "WyFileHandle fh(void) const throw()"
.TP
    Get the file handle of *this
.PP
    [\fBRet\fP] file handle which contains the exact file descriptor
          of *this
.\"--------------------------------------------
.PP
.BI "WyRet stat(WyFileStat& " "filestat" ") const" 
.PP
    Reset \fIfilestat\fP with the file information *this associates
.PP
    [\fBRet\fP] Ok              Succeed.
          Wym_EBADF       Object is not valid for the operation
          Wym_ENOMEM      Not enough memory
          ...
.PP 
    [\fBRefer\fP] ::fstat(int,struct stat*)
.\"--------------------------------------------
.PP
.BI "virtual WyRet reset(void)" 
.PP
    Reconstruct *this to the state as WyFifoFile()
.PP
    [\fBRet\fP] Ok              Succeed.
          Wym_EIO         low level I/O error
          Wym_EINTR       a signal had occurred
          ...             reply converted from the errno ::close 
                          returned
    
    Note: Object is always default while returned.
.PP 
    [\fBRefer\fP] ::close(int)
.\"--------------------------------------------
.PP
.BI "virtual WyRet reset(WyFileHandle " "h" ")" 
.PP
    Reconstruct *this to the state as WyFifoFile(\fIh\fP)
.PP
    [\fBRet\fP] Ok              Succeed. Error report from closing the 
                          previously associated device is ignored
          Wym_EBADF       \fIh\fP is not valid for the operation
          Wym_EMFILE      Too many open fd

    Note: Error report from closing the previously handled
          object is ignored. Use reset() first if the close
          return status is desired
.PP 
    [\fBRefer\fP] ::dup(int)
.\"--------------------------------------------
.PP
.BI "virtual WyRet reset(const WySysFile& " "ff" ")"
.PP
    Reconstruct *this to the state as WyFifoFile(\fIff\fP)
.PP
    [\fBRet\fP] Ok              Succeed.
          Wym_EBADF       \fIff\fP is not valid for the operation
          Wym_EMFILE      Too many open fd

    Note: Error report from closing the previously handled
          object is ignored. Use reset() first if the close
          return status is desired
.PP 
    [\fBRefer\fP] ::dup(int)
.\"--------------------------------------------