Annotation of libaitio/inc/aitio.h, revision 1.36.2.2

1.1       misho       1: /*************************************************************************
1.8       misho       2: * (C) 2010 AITNET ltd - Sofia/Bulgaria - <misho@aitnet.org>
                      3: *  by Michael Pounov <misho@elwix.org>
1.1       misho       4: *
                      5: * $Author: misho $
1.36.2.2! misho       6: * $Id: aitio.h,v 1.36.2.1 2013/11/21 12:54:21 misho Exp $
1.1       misho       7: *
1.8       misho       8: **************************************************************************
                      9: The ELWIX and AITNET software is distributed under the following
                     10: terms:
                     11: 
                     12: All of the documentation and software included in the ELWIX and AITNET
                     13: Releases is copyrighted by ELWIX - Sofia/Bulgaria <info@elwix.org>
                     14: 
1.29      misho      15: Copyright 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013
1.8       misho      16:        by Michael Pounov <misho@elwix.org>.  All rights reserved.
                     17: 
                     18: Redistribution and use in source and binary forms, with or without
                     19: modification, are permitted provided that the following conditions
                     20: are met:
                     21: 1. Redistributions of source code must retain the above copyright
                     22:    notice, this list of conditions and the following disclaimer.
                     23: 2. Redistributions in binary form must reproduce the above copyright
                     24:    notice, this list of conditions and the following disclaimer in the
                     25:    documentation and/or other materials provided with the distribution.
                     26: 3. All advertising materials mentioning features or use of this software
                     27:    must display the following acknowledgement:
                     28: This product includes software developed by Michael Pounov <misho@elwix.org>
                     29: ELWIX - Embedded LightWeight unIX and its contributors.
                     30: 4. Neither the name of AITNET nor the names of its contributors
                     31:    may be used to endorse or promote products derived from this software
                     32:    without specific prior written permission.
                     33: 
                     34: THIS SOFTWARE IS PROVIDED BY AITNET AND CONTRIBUTORS ``AS IS'' AND
                     35: ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     36: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     37: ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
                     38: FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     39: DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     40: OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     41: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     42: LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     43: OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     44: SUCH DAMAGE.
                     45: */
1.1       misho      46: #ifndef __AITIO_H
                     47: #define __AITIO_H
                     48: 
                     49: 
1.12      misho      50: #define COMPAT_43TTY
                     51: 
1.8       misho      52: #include <assert.h>
1.24      misho      53: #include <syslog.h>
1.7       misho      54: #include <openssl/evp.h>
1.12      misho      55: #include <openssl/aes.h>
                     56: #include <sys/tty.h>
                     57: #include <sys/ioctl_compat.h>
1.13      misho      58: #include <sys/socket.h>
                     59: #include <sys/un.h>
1.24      misho      60: #include <sys/uio.h>
1.13      misho      61: #include <net/if_dl.h>
1.33      misho      62: #include <net/bpf.h>
1.13      misho      63: #include <netinet/in.h>
1.34      misho      64: #include <elwix.h>
1.36.2.1  misho      65: #include <aitsched.h>
1.7       misho      66: 
                     67: 
1.21      misho      68: #ifndef STRSIZ
1.34      misho      69: #define STRSIZ                 256
1.21      misho      70: #endif
                     71: 
1.34      misho      72: #define IO_SOCK_ROLE_CLIENT    0
                     73: #define IO_SOCK_ROLE_SERVER    1
                     74: 
1.36      misho      75: #define IO_ETHER_FILTER_PROMISC        0
                     76: #define IO_ETHER_FILTER_NOTREAD        -1
                     77: #define IO_ETHER_FILTER_READ   1
                     78: #define IO_ETHER_FILTER_WRITE  2
                     79: 
1.34      misho      80: 
1.35      misho      81: typedef struct tagCliSock sock_cli_t;
                     82: typedef void *(*sock_cb_t)(sock_cli_t*);
                     83: struct tagCliSock {
                     84:        void                            *cli_parent;
                     85:        int                             cli_fd;
                     86:        int                             cli_pty;
                     87:        sockaddr_t                      cli_addr;
                     88:        char                            cli_name[64];
                     89: 
1.36.2.2! misho      90:        sched_task_func_t               cli_func;
1.35      misho      91: 
                     92:        ait_val_t                       cli_buf;
                     93: 
                     94:        TAILQ_ENTRY(tagCliSock)         cli_node;
                     95: };
1.36.2.2! misho      96: 
1.34      misho      97: typedef struct {
1.35      misho      98:        int                             sock_role;
                     99:        int                             sock_backq;
                    100:        int                             sock_type;
                    101:        int                             sock_proto;
                    102:        int                             sock_fd;
1.36.2.1  misho     103:        struct timespec                 sock_timeout;
1.35      misho     104:        sockaddr_t                      sock_addr;
                    105:        sockaddr_t                      sock_peer;
1.34      misho     106: 
1.35      misho     107:        ait_val_t                       sock_buf;
1.34      misho     108: 
1.36.2.1  misho     109:        volatile intptr_t               sock_kill;
                    110:        sched_root_task_t               *sock_root;
                    111: 
1.35      misho     112:        pthread_mutex_t                 sock_mtx;
                    113:        TAILQ_HEAD(, tagCliSock)        sock_cli;
1.34      misho     114: } sock_t;
                    115: 
1.15      misho     116: 
1.1       misho     117: // io_GetErrno() Get error code of last operation
1.30      misho     118: int io_GetErrno();
1.1       misho     119: // io_GetError() Get error text of last operation
1.30      misho     120: const char *io_GetError();
1.1       misho     121: 
                    122: 
1.12      misho     123: /*
1.34      misho     124:  * ioInitSocket() - Init socket and allocate resources
                    125:  *
                    126:  * @role = Socket role
                    127:  * @type = Socket type
                    128:  * @proto = Socket protocol
                    129:  * @addr = Bind to address
                    130:  * @port = Bind to port
                    131:  * @buflen = Socket buffer, optional if =0 == BUFSIZ
                    132:  * return: NULL error or !=NULL created socket
                    133:  */
                    134: sock_t *ioInitSocket(int role, int type, int proto, 
                    135:                const char *addr, unsigned short port, size_t buflen);
                    136: /*
                    137:  * ioCloseSocket() - Close socket and free resources
                    138:  *
                    139:  * @s = Socket
                    140:  * return: none
                    141:  */
                    142: void ioCloseSocket(sock_t ** __restrict s);
                    143: /*
                    144:  * ioUpSocket() - Setup socket for use
                    145:  *
                    146:  * @s = Socket
                    147:  * @arg = Server role = listen backlog queue and Client role = peer address
1.36.2.1  misho     148:  * @timeout = Socket timeout in ms (default -1 infinit)
1.34      misho     149:  * return: -1 error or 0 ok
                    150:  */
1.36.2.1  misho     151: int ioUpSocket(sock_t * __restrict s, void *arg, int timeout);
                    152: /*
1.36.2.2! misho     153:  * ioUpdTimerSocket() - Update timeout of socket
        !           154:  *
        !           155:  * @c = Client socket
        !           156:  * return:  none
        !           157:  */
        !           158: void ioUpdTimerSocket(sock_cli_t * __restrict c);
        !           159: /*
1.36.2.1  misho     160:  * ioLoopSocket() - Start socket scheduler
                    161:  *
                    162:  * @s = Socket
1.36.2.2! misho     163:  * @rcb = Read callback
1.36.2.1  misho     164:  * return: -1 error or return result from scheduler
                    165:  */
1.36.2.2! misho     166: int ioLoopSocket(sock_t * __restrict s, sched_task_func_t rcb);
1.35      misho     167: /*
                    168:  * ioAcceptSocket() - Accept clients
                    169:  *
                    170:  * @s = Socket
                    171:  * @f = callback function for client handling
                    172:  * @arg = optional argument for callback function
                    173:  * return: -1 error or 0 ok
                    174:  */
                    175: int ioAcceptSocket(sock_t * __restrict s, sock_cb_t f, void *arg);
1.34      misho     176: 
                    177: /*
1.17      misho     178:  * ioPromptRead() - Read data from input h[0] with prompt to output h[1]
1.16      misho     179:  *
1.1       misho     180:  * @h = file handles h[0] = input, h[1] = output, if NULL use stdin, stdout
                    181:  * @csPrompt = Prompt before input, may be NULL
                    182:  * @psData = Readed data
                    183:  * @dataLen = Length of data
                    184:  * return: 0 EOF; -1 error:: can`t read; >0 count of readed chars
                    185: */
                    186: int ioPromptRead(int *h, const char *csPrompt, char * __restrict psData, int dataLen);
                    187: /*
1.17      misho     188:  * ioPromptPassword() - Read password from input h[0] with prompt to output h[1]
1.16      misho     189:  *
1.1       misho     190:  * @h = file handles h[0] = input, h[1] = output, if NULL use stdin, stdout
                    191:  * @csPrompt = Prompt before input, may be NULL
                    192:  * @psPass = Readed password
                    193:  * @passLen = Length of password
                    194:  * @confirm = Confirm password, 0 - get password, !=0 Ask for confirmation
                    195:  * return: 0 EOF; -1 error:: can`t read; >0 count of readed chars
                    196: */
                    197: int ioPromptPassword(int *h, const char *csPrompt, char * __restrict psPass, int passLen, int confirm);
                    198: 
1.10      misho     199: 
                    200: /*
1.17      misho     201:  * ioMkDir() - Function for racursive directory creation and validation
1.16      misho     202:  *
1.5       misho     203:  * @csDir = Full directory path
                    204:  * @mode = Mode for directory creation if missing dir
                    205:  * return: -1 error, 0 directory path exist, >0 created missing dirs
                    206: */
                    207: int ioMkDir(const char *csDir, int mode);
                    208: 
1.6       misho     209: /*
1.17      misho     210:  * ioWatchDirLoop() - Function for watching changes in directory and fire callback
1.16      misho     211:  *
1.6       misho     212:  * @csDir = Full directory path
                    213:  * @callback = Callback if raise event! nOp -1 delete, 0 change/move, 1 create
                    214:  * return: -1 error, !=-1 ok, number of total signaled events
                    215: */
                    216: int ioWatchDirLoop(const char *csDir, int (*callback)(const char *csName, int nOp));
                    217: 
1.5       misho     218: 
1.24      misho     219: #ifdef AIO_OPS
                    220: /*
                    221:  * io_aiobulk() - AIO bulk R/W function
                    222:  *
                    223:  * @mode = Bulk wait mode
                    224:  * @acbs = List of aiocb structures
                    225:  * @nacb = Number of aiocb in list
                    226:  * @sig = Event for completed operations, may be =NULL
                    227:  * return: -1 error or 0 ok
                    228:  */
1.30      misho     229: int io_aiobulk(int mode, struct aiocb ** __restrict acbs, int nacb, 
1.24      misho     230:                struct sigevent *sig);
                    231: #endif
                    232: /*
                    233:  * io_rreadv() - Raw VFS bulk read function
                    234:  *
                    235:  * @fd = File handle
                    236:  * @bufs = Read buffers
                    237:  * @nbufs = Number of read buffers
                    238:  * @offset = Read from position, if -1 read nbytes from current position
                    239:  * @update = Update file handle position !0
                    240:  * return: -1 error or !=-1 readed bytes
                    241:  */
                    242: int io_rreadv(int fd, struct iovec * __restrict bufs, int nbufs, off_t offset, 
                    243:                int update);
                    244: /*
                    245:  * io_rwritev() - Raw VFS bulk write function
                    246:  *
                    247:  * @fd = File handle
                    248:  * @bufs = Write buffers
                    249:  * @nbufs = Number of write buffers
                    250:  * @offset = Write to position, if -1 write nbytes to current position
                    251:  * @update = Update file handle position !0
                    252:  * return: -1 error or !=-1 written bytes
                    253:  */
                    254: int io_rwritev(int fd, struct iovec * __restrict bufs, int nbufs, off_t offset, 
                    255:                int update);
1.5       misho     256: /*
1.17      misho     257:  * io_rread() - Raw VFS read function
1.16      misho     258:  *
1.5       misho     259:  * @fd = File handle
                    260:  * @buf = Read buffer
                    261:  * @nbytes = Read buffer size
                    262:  * @offset = Read from position, if -1 read nbytes from current position
                    263:  * @update = Update file handle position !0
                    264:  * return: -1 error or !=-1 readed bytes
                    265:  */
1.30      misho     266: int io_rread(int fd, void * __restrict buf, size_t nbytes, off_t offset, 
1.24      misho     267:                int update);
1.5       misho     268: /*
1.17      misho     269:  * io_rwrite() - Raw VFS write function
1.16      misho     270:  *
1.5       misho     271:  * @fd = File handle
                    272:  * @buf = Write buffer
                    273:  * @nbytes = Write bytes from buffer
                    274:  * @offset = Write at position, if -1 write nbytes from current position
                    275:  * @update = Update file handle position !0
1.24      misho     276:  * return: -1 error or !=-1 written bytes
1.5       misho     277:  */
1.30      misho     278: int io_rwrite(int fd, void * __restrict buf, size_t nbytes, off_t offset, 
1.24      misho     279:                int update);
1.5       misho     280: 
                    281: /* Disk I/O helper macros */
                    282: #define io_read(f, b, n) io_rread(f, b, n, -1, 1)
                    283: #define io_write(f, b, n) io_rwrite(f, b, n, -1, 1)
                    284: 
                    285: 
1.7       misho     286: /* Crypto framework */
                    287: 
                    288: /*
1.17      misho     289:  * ioCipher() - Cipher wrapper for all supported crypto algorythms
1.16      misho     290:  *
1.7       misho     291:  * @pInput = input buffer
                    292:  * @inLen = input buffer len
1.29      misho     293:  * @ppOutput = output allocated buffe, must be e_free after use
1.7       misho     294:  * @Cipher = cipher engine, like EVP_bf_cbc() or etc...
                    295:  * @pKey = key
                    296:  * @pIV = IV, salt (8 bytes)
                    297:  * @nMode = Mode 0 - decrypting or 1 - encrypting
                    298:  * return: 0 not present data or error!; >0 number of processed and returned bytes into ppOutput
                    299: */
                    300: int ioCipher(unsigned char *pInput, int inLen, unsigned char **ppOutput, const EVP_CIPHER *Cipher, 
                    301:                unsigned char *pKey, unsigned char *pIV, int nMode);
                    302: 
                    303: /*
1.17      misho     304:  * io_Blowfish() - Blowfish cipher algorythm, work with ASCII hex strings
1.16      misho     305:  *
1.7       misho     306:  * @pInput = input buffer
                    307:  * @inLen = input buffer len
1.29      misho     308:  * @ppOutput = output allocated buffe, must be e_free after use
1.7       misho     309:  * @pKey = key
                    310:  * @pIV = IV, salt (8 bytes)
                    311:  * @nMode = Mode 0 - decrypting or 1 - encrypting
                    312:  * return: 0 not present data or error!; >0 number of processed and returned bytes into ppOutput
                    313: */
1.8       misho     314: int io_Blowfish(unsigned char *pInput, int inLen, unsigned char **ppOutput, 
                    315:                unsigned char *pKey, unsigned char *pIV, int nMode);
1.12      misho     316: /*
1.17      misho     317:  * io_ctr_AES() - Encrypt/Decrypt stream cipher CTR_AES
1.16      misho     318:  *
1.12      misho     319:  * @pInput = Input buffer with ASCII
                    320:  * @inLen = Input buffer data length
1.29      misho     321:  * @ppOutput = Output buffer with cipher data, must be e_free after use
1.12      misho     322:  * @pKey = Key
                    323:  * @IV = IVector/Nonce/Counter, Warning: IV must be variable, because we write there!!!
                    324:  * return: -1 error or >-1 how many cipher blocks proceeded
                    325:  */
                    326: int io_ctr_AES(unsigned char *pInput, int inLen, unsigned char **ppOutput, 
                    327:                unsigned char *pKey, unsigned char IV[AES_BLOCK_SIZE]);
                    328: 
                    329: 
                    330: /*
1.17      misho     331:  * ioAllocPTY() - Allocate new PTY and TTY
1.16      misho     332:  *
1.12      misho     333:  * @ptyfd = master fd, pty
                    334:  * @ttyfd = slave fd, tty
                    335:  * @name = tty device name if not null
                    336:  * @namesiz = name length, must be above 63 bytes.
                    337:  * @term = termios for terminal
                    338:  * @winz = winsize for terminal
                    339:  * return: -1 error or 0 ok
                    340:  */
1.30      misho     341: int ioAllocPTY(int *ptyfd, int *ttyfd, char * __restrict name, int namesiz, 
1.12      misho     342:                struct termios * __restrict term, struct winsize * __restrict winz);
                    343: /*
1.17      misho     344:  * ioFreePTY() - Release PTY and TTY device
1.16      misho     345:  *
1.12      misho     346:  * @ptyfd = master fd, pty (==-1 skip closing pty)
                    347:  * @ttyname = tty filename
                    348:  * return: none
                    349:  */
1.30      misho     350: void ioFreePTY(int ptyfd, const char *ttyname);
1.12      misho     351: /*
1.17      misho     352:  * ioChgWinPTY() - Change window size of PTY
1.16      misho     353:  *
1.12      misho     354:  * @ptyfd = master fd, pty
                    355:  * @row = row
                    356:  * @col = col
                    357:  * @xpxl = x pixels
                    358:  * @ypxl = y pixels
                    359:  * return: -1 error or 0 ok
                    360:  */
1.30      misho     361: int ioChgWinPTY(int ptyfd, unsigned short row, unsigned short col, 
1.12      misho     362:                unsigned short xpxl, unsigned short ypxl);
                    363: /*
1.17      misho     364:  * ioSetOwnerTTY() - Set owner to TTY
1.16      misho     365:  *
1.12      misho     366:  * @ttyname = tty filename
                    367:  * @UID = uid
                    368:  * @GID = gid
                    369:  * return: -1 error or 0 ok
                    370:  */
                    371: int ioSetOwnerTTY(const char *ttyname, uid_t UID, gid_t GID);
                    372: /*
1.17      misho     373:  * ioSetSidTTY() - Makes the process's controlling TTY and sets it to sane modes.
1.16      misho     374:  *
1.12      misho     375:  * @ttyfd = slave fd, tty
                    376:  * @ttyname = tty filename
                    377:  * return: -1 error or 0 ok
                    378:  */
                    379: int ioSetSidTTY(int *ttyfd, const char *ttyname);
                    380: /*
1.17      misho     381:  * ioSetRAWMode() - Enter into RAW mode
1.16      misho     382:  *
1.12      misho     383:  * @fd = tty fd
                    384:  * @otio = saved old termios for later restore if !=NULL
                    385:  * return: -1 error or 0 ok
                    386:  */
1.30      misho     387: int ioSetRAWMode(int fd, struct termios *otio);
1.12      misho     388: /*
1.17      misho     389:  * ioRestoreMode() - Restore termios to tty fd
1.16      misho     390:  *
1.12      misho     391:  * @fd = tty fd
                    392:  * @tio = termios structure for restore
                    393:  * return: -1 error or 0 ok
                    394:  */
1.30      misho     395: int ioRestoreMode(int fd, struct termios tio);
1.12      misho     396: /*
1.17      misho     397:  * ioForkPTY() - Fork new process with session leader and new TTY
1.16      misho     398:  *
1.12      misho     399:  * @ptyfd = master fd, pty
                    400:  * @name = tty device name if not null
                    401:  * @namesiz = name length, must be above 63 bytes.
                    402:  * @term = termios for terminal
                    403:  * @winz = winsize for terminal
                    404:  * @otio = old termios structure for restore
                    405:  * return: -1 error, 0 child process or >0 parent: pid of child
                    406:  */
                    407: pid_t ioForkPTY(int *ptyfd, char * __restrict name, int namesiz, struct termios * __restrict term, 
                    408:                struct winsize * __restrict winz, struct termios * __restrict otio);
                    409: 
                    410: /*
1.17      misho     411:  * ioCreatePIDFile() - Create PID file
1.16      misho     412:  *
1.12      misho     413:  * @csName = PID filename
                    414:  * @ifExists = !=0 if filename exists return error
                    415:  * return: -1 error or 0 ok
                    416:  */
1.30      misho     417: int ioCreatePIDFile(const char *csName, int ifExists);
1.7       misho     418: 
1.13      misho     419: /*
1.17      misho     420:  * ioSendFile() - AITNET sendfile() userland implementation, not dependant from OS
1.16      misho     421:  *
1.13      misho     422:  * @s = socket
                    423:  * @csFile = file for send
                    424:  * @sendLen = bytes to send, if 0 send all data
                    425:  * @offset = start file offset
                    426:  * @sndbuf = SO_SNDBUF value, if 0 use default
                    427:  * return: 0 error, >0 ok, sended bytes
                    428:  */
                    429: size_t ioSendFile(int s, const char *csFile, size_t sendLen, off_t offset, int sndbuf);
                    430: /*
1.17      misho     431:  * ioRecvFile() - Receive file from socket, fastest (zero-copy) way
1.16      misho     432:  *
1.13      misho     433:  * @s = socket
                    434:  * @csFile = file for receive
                    435:  * @recvLen = receive bytes
                    436:  * @over = overwrite file if exists with mode like 0644
                    437:  * @rcvbuf = SO_RCVBUF value, if 0 use default
                    438:  * return: 0 error, >0 ok, received bytes
                    439:  */
                    440: size_t ioRecvFile(int s, const char *csFile, size_t recvLen, int over, int rcvbuf);
                    441: 
1.31      misho     442: /*
                    443:  * ioRealFileName() - Get real file name
                    444:  *
                    445:  * @fname = filename
                    446:  * return: =NULL error or !=NULL real filename, should be free with e_free()
                    447:  */
                    448: char *ioRealFileName(const char *fname);
1.7       misho     449: 
1.14      misho     450: /* Buffered file access over memory block */
                    451: 
                    452: /*
1.17      misho     453:  * io_fmemopen() - File buffered stream operations over memory block
1.14      misho     454:  *
                    455:  * @base = Base address of memory block, if =NULL Infinit length(auto-grow)
                    456:  * @basesize = Size of memory block
                    457:  * return: NULL error or !=NULL Opened file resource
                    458:  */
                    459: FILE *io_fmemopen(void ** __restrict base, off_t basesize);
                    460: /*
1.17      misho     461:  * io_fmapopen() - File buffered stream operations over MMAP block
1.14      misho     462:  *
                    463:  * @csFile = Filename for MMAP, if =NULL private MMAP block
                    464:  * @mode = File open mode
                    465:  * @perm = If file not exists will be created with this access permissions
                    466:  * @prot = MMAP protection
                    467:  * @flags = MMAP mode flags
                    468:  * @offset = Map from file offset, if csFile==NULL then this is size of MMAP private block
                    469:  * return: NULL error or !=NULL Opened file resource
                    470:  */
                    471: FILE *io_fmapopen(const char *csFile, int mode, int perm, int prot, int flags, off_t offset);
                    472: /*
1.17      misho     473:  * io_fd2buf() - Convert open file handle to buffered file I/O
1.14      misho     474:  *
                    475:  * @fd = File handle
                    476:  * @mode = Permissions for new buffered file I/O
                    477:  * return: NULL error or open buffered file
                    478:  */
1.30      misho     479: FILE *io_fd2buf(int fd, const char *mode);
1.14      misho     480: /*
1.17      misho     481:  * io_dumbFile() - Create empry or dumb file with fixed size
1.14      misho     482:  *
                    483:  * @csFile = Filename for create
                    484:  * @mode = File access permissions
                    485:  * @size = File size
                    486:  * return: -1 error or open file handle
                    487:  */
                    488: int io_dumbFile(const char *csFile, int mode, off_t size);
                    489: 
                    490: 
1.32      misho     491: /*
                    492:  * io_get1stiface() - Get first interface of host
                    493:  *
                    494:  * @szIface = interface string buffer
                    495:  * @iflen = size of interface buffer
                    496:  * return: -1 error or 0 ok
                    497:  */
                    498: int io_get1stiface(char *szIface, int iflen);
                    499: /*
                    500:  * io_etherOpen() - Open BPF interface to device
                    501:  *
                    502:  * @csIface = interface name
                    503:  * @flags = open flags
                    504:  * @whdr = with complete headers
1.33      misho     505:  * @wdlt = with data link type
1.32      misho     506:  * @buflen = buffer length
                    507:  * @zcbuf = zero copy buffer, if BPF supports it and isn't NULL
                    508:  * return: -1 error or >-1 bpf handle
                    509:  */
1.33      misho     510: int io_etherOpen(const char *csIface, int flags, int whdr, int wdlt, 
1.32      misho     511:                unsigned int *buflen, void **zcbuf);
                    512: /*
                    513:  * io_etherClose() - Close BPF interface
                    514:  *
                    515:  * @eth = bpf handle
                    516:  * @zcbuf = zero copy buffer, if BPF supports it and isn't NULL
                    517:  * return: none
                    518:  */
                    519: void io_etherClose(int eth, void **zcbuf);
                    520: 
                    521: /*
1.36      misho     522:  * io_etherFilter() - BPF filter routine
                    523:  *
                    524:  * @eth = bpf handle
                    525:  * @io = filter direction 
                    526:  *  (IO_ETHER_FILTER_PROMISC|IO_ETHER_FILTER_NOTREAD|IO_ETHER_FILTER_READ|IO_ETHER_FILTER_WRITE)
                    527:  * @insn = BPF filter instruction array
                    528:  * @insnlen = Length of BPF filter instruction array
                    529:  * return: -1 error or 0 ok
                    530:  */
                    531: int io_etherFilter(int eth, int io, struct bpf_insn * __restrict insn, size_t insnlen);
                    532: 
                    533: /*
1.32      misho     534:  * io_etherSend() - Send packet to bpf
                    535:  *
                    536:  * @eth = bpf handle
                    537:  * @buf = buffer
                    538:  * @buflen = buffer length
                    539:  * return: -1 error or !=-1 written bytes
                    540:  */
                    541: ssize_t io_etherSend(int eth, const void *buf, size_t buflen);
                    542: /*
                    543:  * io_etherRecv() - Receive packet from bpf
                    544:  *
                    545:  * @eth = bpf handle
                    546:  * @buf = buffer
                    547:  * @buflen = buffer length
                    548:  * @zcbuf = zero copy buffer, if BPF supports it and isn't NULL
                    549:  * return: -1 error or !=-1 readed bytes
                    550:  */
                    551: ssize_t io_etherRecv(int eth, void * __restrict buf, 
                    552:                size_t buflen, void * __restrict zcbuf);
                    553: 
                    554: 
1.1       misho     555: #endif

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>