b61160eb2d0271fddd91f53a8e3f5f85318a44f7
[people/dverkamp/gpxe.git] / src / core / open.c
1 /*
2  * Copyright (C) 2007 Michael Brown <mbrown@fensystems.co.uk>.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License as
6  * published by the Free Software Foundation; either version 2 of the
7  * License, or any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
17  */
18
19 #include <stdarg.h>
20 #include <string.h>
21 #include <errno.h>
22 #include <gpxe/xfer.h>
23 #include <gpxe/uri.h>
24 #include <gpxe/socket.h>
25 #include <gpxe/open.h>
26
27 /** @file
28  *
29  * Data transfer interface opening
30  *
31  */
32
33 /** Registered URI openers */
34 static struct uri_opener uri_openers[0]
35         __table_start ( struct uri_opener, uri_openers );
36 static struct uri_opener uri_openers_end[0]
37         __table_end ( struct uri_opener, uri_openers );
38
39 /** Registered socket openers */
40 static struct socket_opener socket_openers[0]
41         __table_start ( struct socket_opener, socket_openers );
42 static struct socket_opener socket_openers_end[0]
43         __table_end ( struct socket_opener, socket_openers );
44
45 /**
46  * Open URI
47  *
48  * @v xfer              Data transfer interface
49  * @v uri_string        URI string (e.g. "http://etherboot.org/kernel")
50  * @ret rc              Return status code
51  */
52 int xfer_open_uri ( struct xfer_interface *xfer, const char *uri_string ) {
53         struct uri *uri;
54         struct uri_opener *opener;
55
56         DBGC ( xfer, "XFER %p opening URI %s\n", xfer, uri_string );
57
58         uri = parse_uri ( uri_string );
59         if ( ! uri )
60                 return -ENOMEM;
61
62         for ( opener = uri_openers ; opener < uri_openers_end ; opener++ ) {
63                 if ( strcmp ( uri->scheme, opener->scheme ) == 0 ) {
64                         return opener->open ( xfer, uri );
65                 }
66         }
67
68         DBGC ( xfer, "XFER %p attempted to open unsupported URI scheme "
69                "\"%s\"\n", xfer, uri->scheme );
70         free_uri ( uri );
71         return -ENOTSUP;
72 }
73
74 /**
75  * Open socket
76  *
77  * @v xfer              Data transfer interface
78  * @v semantics         Communication semantics (e.g. SOCK_STREAM)
79  * @v peer              Peer socket address
80  * @v local             Local socket address, or NULL
81  * @ret rc              Return status code
82  */
83 int xfer_open_socket ( struct xfer_interface *xfer, int semantics,
84                        struct sockaddr *peer, struct sockaddr *local ) {
85         struct socket_opener *opener;
86
87         DBGC ( xfer, "XFER %p opening (%s,%s) socket\n", xfer,
88                socket_semantics_name ( semantics ),
89                socket_family_name ( peer->sa_family ) );
90
91         for ( opener = socket_openers; opener < socket_openers_end; opener++ ){
92                 if ( ( opener->semantics == semantics ) &&
93                      ( opener->family == peer->sa_family ) ) {
94                         return opener->open ( xfer, peer, local );
95                 }
96         }
97
98         DBGC ( xfer, "XFER %p attempted to open unsupported socket type "
99                "(%s,%s)\n", xfer, socket_semantics_name ( semantics ),
100                socket_family_name ( peer->sa_family ) );
101         return -ENOTSUP;
102 }
103
104 /**
105  * Open location
106  *
107  * @v xfer              Data transfer interface
108  * @v type              Location type
109  * @v args              Remaining arguments depend upon location type
110  * @ret rc              Return status code
111  */
112 int xfer_vopen ( struct xfer_interface *xfer, int type, va_list args ) {
113         switch ( type ) {
114         case LOCATION_URI: {
115                 const char *uri_string = va_arg ( args, const char * );
116
117                 return xfer_open_uri ( xfer, uri_string ); }
118         case LOCATION_SOCKET: {
119                 int semantics = va_arg ( args, int );
120                 struct sockaddr *peer = va_arg ( args, struct sockaddr * );
121                 struct sockaddr *local = va_arg ( args, struct sockaddr * );
122
123                 return xfer_open_socket ( xfer, semantics, peer, local ); }
124         default:
125                 DBGC ( xfer, "XFER %p attempted to open unsupported location "
126                        "type %d\n", xfer, type );
127                 return -ENOTSUP;
128         }
129 }
130
131 /**
132  * Open location
133  *
134  * @v xfer              Data transfer interface
135  * @v type              Location type
136  * @v ...               Remaining arguments depend upon location type
137  * @ret rc              Return status code
138  */
139 int xfer_open ( struct xfer_interface *xfer, int type, ... ) {
140         va_list args;
141         int rc;
142
143         va_start ( args, type );
144         rc = xfer_vopen ( xfer, type, args );
145         va_end ( args );
146         return rc;
147 }