mirror of
https://github.com/xcat2/xNBA.git
synced 2026-06-24 16:30:43 +00:00
Michael Brown
4327d5d39f
Remove data-xfer as an interface type, and replace data-xfer interfaces with generic interfaces supporting the data-xfer methods. Filter interfaces (as used by the TLS layer) are handled using the generic pass-through interface capability. A side-effect of this is that deliver_raw() no longer exists as a data-xfer method. (In practice this doesn't lose any efficiency, since there are no instances within the current codebase where xfer_deliver_raw() is used to pass data to an interface supporting the deliver_raw() method.) Signed-off-by: Michael Brown <mcb30@ipxe.org>
106 lines
2.4 KiB
C
106 lines
2.4 KiB
C
#ifndef _IPXE_OPEN_H
|
|
#define _IPXE_OPEN_H
|
|
|
|
/** @file
|
|
*
|
|
* Data transfer interface opening
|
|
*
|
|
*/
|
|
|
|
FILE_LICENCE ( GPL2_OR_LATER );
|
|
|
|
#include <stdarg.h>
|
|
#include <ipxe/tables.h>
|
|
#include <ipxe/socket.h>
|
|
|
|
struct uri;
|
|
struct interface;
|
|
|
|
/** Location types */
|
|
enum {
|
|
/** Location is a URI
|
|
*
|
|
* Parameter list for open() is:
|
|
*
|
|
* struct uri *uri;
|
|
*/
|
|
LOCATION_URI = 1,
|
|
/** Location is a URI string
|
|
*
|
|
* Parameter list for open() is:
|
|
*
|
|
* const char *uri_string;
|
|
*/
|
|
LOCATION_URI_STRING,
|
|
/** Location is a socket
|
|
*
|
|
* Parameter list for open() is:
|
|
*
|
|
* int semantics;
|
|
* struct sockaddr *peer;
|
|
* struct sockaddr *local;
|
|
*/
|
|
LOCATION_SOCKET,
|
|
};
|
|
|
|
/** A URI opener */
|
|
struct uri_opener {
|
|
/** URI protocol name
|
|
*
|
|
* This is the "scheme" portion of the URI, e.g. "http" or
|
|
* "file".
|
|
*/
|
|
const char *scheme;
|
|
/** Open URI
|
|
*
|
|
* @v intf Object interface
|
|
* @v uri URI
|
|
* @ret rc Return status code
|
|
*/
|
|
int ( * open ) ( struct interface *intf, struct uri *uri );
|
|
};
|
|
|
|
/** URI opener table */
|
|
#define URI_OPENERS __table ( struct uri_opener, "uri_openers" )
|
|
|
|
/** Register a URI opener */
|
|
#define __uri_opener __table_entry ( URI_OPENERS, 01 )
|
|
|
|
/** A socket opener */
|
|
struct socket_opener {
|
|
/** Communication semantics (e.g. SOCK_STREAM) */
|
|
int semantics;
|
|
/** Address family (e.g. AF_INET) */
|
|
int family;
|
|
/** Open socket
|
|
*
|
|
* @v intf Object interface
|
|
* @v peer Peer socket address
|
|
* @v local Local socket address, or NULL
|
|
* @ret rc Return status code
|
|
*/
|
|
int ( * open ) ( struct interface *intf, struct sockaddr *peer,
|
|
struct sockaddr *local );
|
|
};
|
|
|
|
/** Socket opener table */
|
|
#define SOCKET_OPENERS __table ( struct socket_opener, "socket_openers" )
|
|
|
|
/** Register a socket opener */
|
|
#define __socket_opener __table_entry ( SOCKET_OPENERS, 01 )
|
|
|
|
extern int xfer_open_uri ( struct interface *intf, struct uri *uri );
|
|
extern int xfer_open_uri_string ( struct interface *intf,
|
|
const char *uri_string );
|
|
extern int xfer_open_named_socket ( struct interface *intf, int semantics,
|
|
struct sockaddr *peer, const char *name,
|
|
struct sockaddr *local );
|
|
extern int xfer_open_socket ( struct interface *intf, int semantics,
|
|
struct sockaddr *peer, struct sockaddr *local );
|
|
extern int xfer_vopen ( struct interface *intf, int type, va_list args );
|
|
extern int xfer_open ( struct interface *intf, int type, ... );
|
|
extern int xfer_vreopen ( struct interface *intf, int type,
|
|
va_list args );
|
|
|
|
#endif /* _IPXE_OPEN_H */
|