OLD | NEW |
1 // Copyright (c) 2008 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2008 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 // Written in NSPR style to also be suitable for adding to the NSS demo suite | 4 // Written in NSPR style to also be suitable for adding to the NSS demo suite |
5 | 5 |
6 #ifndef __MEMIO_H | 6 #ifndef __MEMIO_H |
7 #define __MEMIO_H | 7 #define __MEMIO_H |
8 | 8 |
9 #include <stddef.h> | 9 #include <stddef.h> |
10 | 10 |
11 #ifdef __cplusplus | 11 #ifdef __cplusplus |
12 extern "C" { | 12 extern "C" { |
13 #endif | 13 #endif |
14 | 14 |
15 #include "prio.h" | 15 #include "prio.h" |
16 | 16 |
17 struct sockaddr; | |
18 | |
19 /* Opaque structure. Really just a more typesafe alias for PRFilePrivate. */ | 17 /* Opaque structure. Really just a more typesafe alias for PRFilePrivate. */ |
20 struct memio_Private; | 18 struct memio_Private; |
21 typedef struct memio_Private memio_Private; | 19 typedef struct memio_Private memio_Private; |
22 | 20 |
23 /*---------------------------------------------------------------------- | 21 /*---------------------------------------------------------------------- |
24 NSPR I/O layer that terminates in a pair of circular buffers | 22 NSPR I/O layer that terminates in a pair of circular buffers |
25 rather than talking to the real network. | 23 rather than talking to the real network. |
26 To use this with NSS: | 24 To use this with NSS: |
27 1) call memio_CreateIOLayer to create a fake NSPR socket | 25 1) call memio_CreateIOLayer to create a fake NSPR socket |
28 2) call SSL_ImportFD to ssl-ify the socket | 26 2) call SSL_ImportFD to ssl-ify the socket |
29 3) Do your own networking calls to set up a TCP connection | 27 3) Do your own networking calls to set up a TCP connection |
30 4) call memio_SetPeerName to tell NSS about the other end of the connection | 28 4) call memio_SetPeerName to tell NSS about the other end of the connection |
31 5) While at the same time doing plaintext nonblocking NSPR I/O as | 29 5) While at the same time doing plaintext nonblocking NSPR I/O as |
32 usual to the nspr file descriptor returned by SSL_ImportFD, | 30 usual to the nspr file descriptor returned by SSL_ImportFD, |
33 your app must shuttle encrypted data between | 31 your app must shuttle encrypted data between |
34 the real network and memio's network buffers. | 32 the real network and memio's network buffers. |
35 memio_GetReadParams/memio_PutReadResult | 33 memio_GetReadParams/memio_PutReadResult |
36 are the hooks you need to pump data into memio's input buffer, | 34 are the hooks you need to pump data into memio's input buffer, |
37 and memio_GetWriteParams/memio_PutWriteResult | 35 and memio_GetWriteParams/memio_PutWriteResult |
38 are the hooks you need to pump data out of memio's output buffer. | 36 are the hooks you need to pump data out of memio's output buffer. |
39 ----------------------------------------------------------------------*/ | 37 ----------------------------------------------------------------------*/ |
40 | 38 |
41 /* Create the I/O layer and its two circular buffers. */ | 39 /* Create the I/O layer and its two circular buffers. */ |
42 PRFileDesc *memio_CreateIOLayer(int bufsize); | 40 PRFileDesc *memio_CreateIOLayer(int bufsize); |
43 | 41 |
44 /* Must call before trying to make an ssl connection */ | 42 /* Must call before trying to make an ssl connection */ |
45 void memio_SetPeerName(PRFileDesc *fd, const struct sockaddr *peername, | 43 void memio_SetPeerName(PRFileDesc *fd, const PRNetAddr *peername); |
46 size_t peername_len); | |
47 | 44 |
48 /* Return a private pointer needed by the following | 45 /* Return a private pointer needed by the following |
49 * four functions. (We could have passed a PRFileDesc to | 46 * four functions. (We could have passed a PRFileDesc to |
50 * them, but that would be slower. Better for the caller | 47 * them, but that would be slower. Better for the caller |
51 * to grab the pointer once and cache it. | 48 * to grab the pointer once and cache it. |
52 * This may be a premature optimization.) | 49 * This may be a premature optimization.) |
53 */ | 50 */ |
54 memio_Private *memio_GetSecret(PRFileDesc *fd); | 51 memio_Private *memio_GetSecret(PRFileDesc *fd); |
55 | 52 |
56 /* Ask memio where to put bytes from the network, and how many it can handle. | 53 /* Ask memio where to put bytes from the network, and how many it can handle. |
(...skipping 25 matching lines...) Expand all Loading... |
82 * On EWOULDBLOCK or the equivalent, don't call this function. | 79 * On EWOULDBLOCK or the equivalent, don't call this function. |
83 */ | 80 */ |
84 void memio_PutWriteResult(memio_Private *secret, int bytes_written); | 81 void memio_PutWriteResult(memio_Private *secret, int bytes_written); |
85 | 82 |
86 | 83 |
87 #ifdef __cplusplus | 84 #ifdef __cplusplus |
88 } | 85 } |
89 #endif | 86 #endif |
90 | 87 |
91 #endif | 88 #endif |
OLD | NEW |