89a96d72ee2917d20a192006b97d7df9c391babb
[people/lynusvaz/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 /**
34  * Open URI
35  *
36  * @v xfer              Data transfer interface
37  * @v uri               URI
38  * @ret rc              Return status code
39  *
40  * The URI will be regarded as being relative to the current working
41  * URI (see churi()).
42  */
43 int xfer_open_uri ( struct xfer_interface *xfer, struct uri *uri ) {
44         struct uri_opener *opener;
45         struct uri *resolved_uri;
46         int rc = -ENOTSUP;
47
48         /* Resolve URI */
49         resolved_uri = resolve_uri ( cwuri, uri );
50         if ( ! resolved_uri )
51                 return -ENOMEM;
52
53         /* Find opener which supports this URI scheme */
54         for_each_table_entry ( opener, URI_OPENERS ) {
55                 if ( strcmp ( resolved_uri->scheme, opener->scheme ) == 0 ) {
56                         rc = opener->open ( xfer, resolved_uri );
57                         goto done;
58                 }
59         }
60         DBGC ( xfer, "XFER %p attempted to open unsupported URI scheme "
61                "\"%s\"\n", xfer, resolved_uri->scheme );
62
63  done:
64         uri_put ( resolved_uri );
65         return rc;
66 }
67
68 /**
69  * Open URI string
70  *
71  * @v xfer              Data transfer interface
72  * @v uri_string        URI string (e.g. "http://etherboot.org/kernel")
73  * @ret rc              Return status code
74  *
75  * The URI will be regarded as being relative to the current working
76  * URI (see churi()).
77  */
78 int xfer_open_uri_string ( struct xfer_interface *xfer,
79                            const char *uri_string ) {
80         struct uri *uri;
81         int rc;
82
83         DBGC ( xfer, "XFER %p opening URI %s\n", xfer, uri_string );
84
85         uri = parse_uri ( uri_string );
86         if ( ! uri )
87                 return -ENOMEM;
88
89         rc = xfer_open_uri ( xfer, uri );
90
91         uri_put ( uri );
92         return rc;
93 }
94
95 /**
96  * Open socket
97  *
98  * @v xfer              Data transfer interface
99  * @v semantics         Communication semantics (e.g. SOCK_STREAM)
100  * @v peer              Peer socket address
101  * @v local             Local socket address, or NULL
102  * @ret rc              Return status code
103  */
104 int xfer_open_socket ( struct xfer_interface *xfer, int semantics,
105                        struct sockaddr *peer, struct sockaddr *local ) {
106         struct socket_opener *opener;
107
108         DBGC ( xfer, "XFER %p opening (%s,%s) socket\n", xfer,
109                socket_semantics_name ( semantics ),
110                socket_family_name ( peer->sa_family ) );
111
112         for_each_table_entry ( opener, SOCKET_OPENERS ) {
113                 if ( ( opener->semantics == semantics ) &&
114                      ( opener->family == peer->sa_family ) ) {
115                         return opener->open ( xfer, peer, local );
116                 }
117         }
118
119         DBGC ( xfer, "XFER %p attempted to open unsupported socket type "
120                "(%s,%s)\n", xfer, socket_semantics_name ( semantics ),
121                socket_family_name ( peer->sa_family ) );
122         return -ENOTSUP;
123 }
124
125 /**
126  * Open location
127  *
128  * @v xfer              Data transfer interface
129  * @v type              Location type
130  * @v args              Remaining arguments depend upon location type
131  * @ret rc              Return status code
132  */
133 int xfer_vopen ( struct xfer_interface *xfer, int type, va_list args ) {
134         switch ( type ) {
135         case LOCATION_URI_STRING: {
136                 const char *uri_string = va_arg ( args, const char * );
137
138                 return xfer_open_uri_string ( xfer, uri_string ); }
139         case LOCATION_URI: {
140                 struct uri *uri = va_arg ( args, struct uri * );
141
142                 return xfer_open_uri ( xfer, uri ); }
143         case LOCATION_SOCKET: {
144                 int semantics = va_arg ( args, int );
145                 struct sockaddr *peer = va_arg ( args, struct sockaddr * );
146                 struct sockaddr *local = va_arg ( args, struct sockaddr * );
147
148                 return xfer_open_socket ( xfer, semantics, peer, local ); }
149         default:
150                 DBGC ( xfer, "XFER %p attempted to open unsupported location "
151                        "type %d\n", xfer, type );
152                 return -ENOTSUP;
153         }
154 }
155
156 /**
157  * Open location
158  *
159  * @v xfer              Data transfer interface
160  * @v type              Location type
161  * @v ...               Remaining arguments depend upon location type
162  * @ret rc              Return status code
163  */
164 int xfer_open ( struct xfer_interface *xfer, int type, ... ) {
165         va_list args;
166         int rc;
167
168         va_start ( args, type );
169         rc = xfer_vopen ( xfer, type, args );
170         va_end ( args );
171         return rc;
172 }