Lines Matching +full:double +full:- +full:buffering
18 .\" Set up some character translations and predefined strings. \*(-- will
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
24 .tr \(*W-
27 . ds -- \(*W-
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
37 . ds -- \|\(em\|
71 .\" Fear. Run. Save yourself. No user-serviceable parts.
81 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
97 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
98 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
99 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
100 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
101 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
102 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
104 . \" troff and (daisy-wheel) nroff accents
123 . ds d- d\h'-1'\(ga
124 . ds D- D\h'-1'\(hy
134 .TH BIO_S_MEM 3ossl "2023-09-19" "3.0.11" "OpenSSL"
142 BIO_get_mem_ptr, BIO_new_mem_buf \- memory BIO
160 \&\fBBIO_s_mem()\fR returns the memory \s-1BIO\s0 method function.
162 A memory \s-1BIO\s0 is a source/sink \s-1BIO\s0 which uses memory for its I/O. Data
163 written to a memory \s-1BIO\s0 is stored in a \s-1BUF_MEM\s0 structure which is extended
169 Any data written to a memory \s-1BIO\s0 can be recalled by reading from it.
170 Unless the memory \s-1BIO\s0 is read only any data read from it is deleted from
171 the \s-1BIO.\s0
175 If the \s-1BIO_CLOSE\s0 flag is set when a memory \s-1BIO\s0 is freed then the underlying
176 \&\s-1BUF_MEM\s0 structure is also freed.
178 Calling \fBBIO_reset()\fR on a read write memory \s-1BIO\s0 clears any data in it if the
179 flag \s-1BIO_FLAGS_NONCLEAR_RST\s0 is not set, otherwise it just restores the read
181 data can be read again. On a read only \s-1BIO\s0 it similarly restores the \s-1BIO\s0 to
184 \&\fBBIO_eof()\fR is true if no data is in the \s-1BIO.\s0
188 \&\fBBIO_set_mem_eof_return()\fR sets the behaviour of memory \s-1BIO\s0 \fBb\fR when it is
189 empty. If the \fBv\fR is zero then an empty memory \s-1BIO\s0 will return \s-1EOF\s0 (that is
193 positive return value \fBv\fR should be set to a negative value, typically \-1.
200 \&\fBBIO_set_mem_buf()\fR sets the internal \s-1BUF_MEM\s0 structure to \fBbm\fR and sets the
201 close flag to \fBc\fR, that is \fBc\fR should be either \s-1BIO_CLOSE\s0 or \s-1BIO_NOCLOSE.\s0
204 \&\fBBIO_get_mem_ptr()\fR places the underlying \s-1BUF_MEM\s0 structure in *\fBpp\fR. It is
207 \&\fBBIO_new_mem_buf()\fR creates a memory \s-1BIO\s0 using \fBlen\fR bytes of data at \fBbuf\fR,
208 if \fBlen\fR is \-1 then the \fBbuf\fR is assumed to be nul terminated and its
209 length is determined by \fBstrlen\fR. The \s-1BIO\s0 is set to a read only state and
211 made available from a static area of memory in the form of a \s-1BIO.\s0 The
213 first, so the supplied area of memory must be unchanged until the \s-1BIO\s0 is freed.
220 to a read write memory \s-1BIO\s0 will have to move the unread data with an internal
221 copy operation, if a \s-1BIO\s0 contains a lot of data and it is read in small
223 a buffering \s-1BIO\s0 to the chain can speed up the process.
225 Calling \fBBIO_set_mem_buf()\fR on a \s-1BIO\s0 created with \fBBIO_new_secmem()\fR will
228 Switching the memory \s-1BIO\s0 from read write to read only is not supported and
231 immediately after \s-1BIO\s0 creation and set the \s-1BIO\s0 as read only.
233 The other supported sequence is to start with read write \s-1BIO\s0 then temporarily
234 switch it to read only and call \fBBIO_reset()\fR on the read only \s-1BIO\s0 immediately
235 before switching it back to read write. Before the \s-1BIO\s0 is freed it must be
238 Calling \fBBIO_get_mem_ptr()\fR on read only \s-1BIO\s0 will return a \s-1BUF_MEM\s0 that
240 \&\s-1BIO\s0 is set to \s-1BIO_NOCLOSE,\s0 before freeing the \s-1BUF_MEM\s0 the data pointer
241 in it must be set to \s-1NULL\s0 as the data pointer does not point to an
244 Calling \fBBIO_reset()\fR on a read write memory \s-1BIO\s0 with \s-1BIO_FLAGS_NONCLEAR_RST\s0
246 \&\s-1BIO\s0 are intertwined. As documented above the \s-1BIO\s0 will be reset to the
251 \&\s-1BIO_FLAGS_NONCLEAR_RST\s0 set has the same effect as a write operation.
253 Calling \fBBIO_set_close()\fR with \s-1BIO_NOCLOSE\s0 orphans the \s-1BUF_MEM\s0 internal to the
254 \&\s-1BIO,\s0 _not_ its actual data buffer. See the examples section for the proper
258 There should be an option to set the maximum size of a memory \s-1BIO.\s0
261 \&\fBBIO_s_mem()\fR and \fBBIO_s_secmem()\fR return a valid memory \fB\s-1BIO_METHOD\s0\fR structur…
267 0 if b is \s-1NULL,\s0 or a negative value in case of other errors.
269 \&\fBBIO_new_mem_buf()\fR returns a valid \fB\s-1BIO\s0\fR structure on success or \s-1NULL\s0 on e…
272 Create a memory \s-1BIO\s0 and write some data to it:
280 Create a read only memory \s-1BIO:\s0
284 \& BIO *mem = BIO_new_mem_buf(data, \-1);
287 Extract the \s-1BUF_MEM\s0 structure from a memory \s-1BIO\s0 and then free up the \s-1BIO:\s0
297 Extract the \s-1BUF_MEM\s0 ptr, claim ownership of the internal data and free the \s-1BIO\s0
298 and \s-1BUF_MEM\s0 structure:
308 \& bptr\->data = NULL; /* Tell BUF_MEM to orphan data */
315 Copyright 2000\-2023 The OpenSSL Project Authors. All Rights Reserved.
319 in the file \s-1LICENSE\s0 in the source distribution or at