libavformat/aviobuf.c

   1 /*
   2  * Buffered I/O for ffmpeg system
   3  * Copyright (c) 2000,2001 Fabrice Bellard
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this library; if not, write to the Free Software
  17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  18  */
  19 #include "avformat.h"
  20 #include "avio.h"
  21 #include <stdarg.h>
  22
  23 #define IO_BUFFER_SIZE 32768
  24
  25 int init_put_byte(ByteIOContext *s,
  26                   unsigned char *buffer,
  27                   int buffer_size,
  28                   int write_flag,
  29                   void *opaque,
  30                   int (*read_packet)(void *opaque, uint8_t *buf, int buf_size),
  31                   int (*write_packet)(void *opaque, uint8_t *buf, int buf_size),
  32                   offset_t (*seek)(void *opaque, offset_t offset, int whence))
  33 {
  34     s->buffer = buffer;
  35     s->buffer_size = buffer_size;
  36     s->buf_ptr = buffer;
  37     s->write_flag = write_flag;
  38     if (!s->write_flag)
  39         s->buf_end = buffer;
  40     else
  41         s->buf_end = buffer + buffer_size;
  42     s->opaque = opaque;
  43     s->write_packet = write_packet;
  44     s->read_packet = read_packet;
  45     s->seek = seek;
  46     s->pos = 0;
  47     s->must_flush = 0;
  48     s->eof_reached = 0;
  49     s->error = 0;
  50     s->is_streamed = 0;
  51     s->max_packet_size = 0;
  52     s->update_checksum= NULL;
  53     return 0;
  54 }
  55
  56
  57 #ifdef CONFIG_ENCODERS
  58 static void flush_buffer(ByteIOContext *s)
  59 {
  60     if (s->buf_ptr > s->buffer) {
  61         if (s->write_packet && !s->error){
  62             int ret= s->write_packet(s->opaque, s->buffer, s->buf_ptr - s->buffer);
  63             if(ret < 0){
  64                 s->error = ret;
  65             }
  66         }
  67         if(s->update_checksum){
  68             s->checksum= s->update_checksum(s->checksum, s->checksum_ptr, s->buf_ptr - s->checksum_ptr);
  69             s->checksum_ptr= s->buffer;
  70         }
  71         s->pos += s->buf_ptr - s->buffer;
  72     }
  73     s->buf_ptr = s->buffer;
  74 }
  75
  76 void put_byte(ByteIOContext *s, int b)
  77 {
  78     *(s->buf_ptr)++ = b;
  79     if (s->buf_ptr >= s->buf_end)
  80         flush_buffer(s);
  81 }
  82
  83 void put_buffer(ByteIOContext *s, const unsigned char *buf, int size)
  84 {
  85     int len;
  86
  87     while (size > 0) {
  88         len = (s->buf_end - s->buf_ptr);
  89         if (len > size)
  90             len = size;
  91         memcpy(s->buf_ptr, buf, len);
  92         s->buf_ptr += len;
  93
  94         if (s->buf_ptr >= s->buf_end)
  95             flush_buffer(s);
  96
  97         buf += len;
  98         size -= len;
  99     }
 100 }
 101
 102 void put_flush_packet(ByteIOContext *s)
 103 {
 104     flush_buffer(s);
 105     s->must_flush = 0;
 106 }
 107 #endif //CONFIG_ENCODERS
 108
 109 offset_t url_fseek(ByteIOContext *s, offset_t offset, int whence)
 110 {
 111     offset_t offset1;
 112
 113     if (whence != SEEK_CUR && whence != SEEK_SET)
 114         return -EINVAL;
 115
 116 #ifdef CONFIG_ENCODERS
 117     if (s->write_flag) {
 118         if (whence == SEEK_CUR) {
 119             offset1 = s->pos + (s->buf_ptr - s->buffer);
 120             if (offset == 0)
 121                 return offset1;
 122             offset += offset1;
 123         }
 124         offset1 = offset - s->pos;
 125         if (!s->must_flush &&
 126             offset1 >= 0 && offset1 < (s->buf_end - s->buffer)) {
 127             /* can do the seek inside the buffer */
 128             s->buf_ptr = s->buffer + offset1;
 129         } else {
 130             if (!s->seek)
 131                 return -EPIPE;
 132             flush_buffer(s);
 133             s->must_flush = 1;
 134             s->buf_ptr = s->buffer;
 135             s->seek(s->opaque, offset, SEEK_SET);
 136             s->pos = offset;
 137         }
 138     } else
 139 #endif //CONFIG_ENCODERS
 140     {
 141         if (whence == SEEK_CUR) {
 142             offset1 = s->pos - (s->buf_end - s->buffer) + (s->buf_ptr - s->buffer);
 143             if (offset == 0)
 144                 return offset1;
 145             offset += offset1;
 146         }
 147         offset1 = offset - (s->pos - (s->buf_end - s->buffer));
 148         if (offset1 >= 0 && offset1 <= (s->buf_end - s->buffer)) {
 149             /* can do the seek inside the buffer */
 150             s->buf_ptr = s->buffer + offset1;
 151         } else {
 152             if (!s->seek)
 153                 return -EPIPE;
 154             s->buf_ptr = s->buffer;
 155             s->buf_end = s->buffer;
 156             if (s->seek(s->opaque, offset, SEEK_SET) == (offset_t)-EPIPE)
 157                 return -EPIPE;
 158             s->pos = offset;
 159         }
 160         s->eof_reached = 0;
 161     }
 162     return offset;
 163 }
 164
 165 void url_fskip(ByteIOContext *s, offset_t offset)
 166 {
 167     url_fseek(s, offset, SEEK_CUR);
 168 }
 169
 170 offset_t url_ftell(ByteIOContext *s)
 171 {
 172     return url_fseek(s, 0, SEEK_CUR);
 173 }
 174
 175 offset_t url_fsize(ByteIOContext *s)
 176 {
 177     offset_t size;
 178
 179     if (!s->seek)
 180         return -EPIPE;
 181     size = s->seek(s->opaque, -1, SEEK_END) + 1;
 182     s->seek(s->opaque, s->pos, SEEK_SET);
 183     return size;
 184 }
 185
 186 int url_feof(ByteIOContext *s)
 187 {
 188     return s->eof_reached;
 189 }
 190
 191 int url_ferror(ByteIOContext *s)
 192 {
 193     return s->error;
 194 }
 195
 196 #ifdef CONFIG_ENCODERS
 197 void put_le32(ByteIOContext *s, unsigned int val)
 198 {
 199     put_byte(s, val);
 200     put_byte(s, val >> 8);
 201     put_byte(s, val >> 16);
 202     put_byte(s, val >> 24);
 203 }
 204
 205 void put_be32(ByteIOContext *s, unsigned int val)
 206 {
 207     put_byte(s, val >> 24);
 208     put_byte(s, val >> 16);
 209     put_byte(s, val >> 8);
 210     put_byte(s, val);
 211 }
 212
 213 /* IEEE format is assumed */
 214 void put_be64_double(ByteIOContext *s, double val)
 215 {
 216     union {
 217         double d;
 218         uint64_t ull;
 219     } u;
 220     u.d = val;
 221     put_be64(s, u.ull);
 222 }
 223
 224 void put_strz(ByteIOContext *s, const char *str)
 225 {
 226     if (str)
 227         put_buffer(s, (const unsigned char *) str, strlen(str) + 1);
 228     else
 229         put_byte(s, 0);
 230 }
 231
 232 void put_le64(ByteIOContext *s, uint64_t val)
 233 {
 234     put_le32(s, (uint32_t)(val & 0xffffffff));
 235     put_le32(s, (uint32_t)(val >> 32));
 236 }
 237
 238 void put_be64(ByteIOContext *s, uint64_t val)
 239 {
 240     put_be32(s, (uint32_t)(val >> 32));
 241     put_be32(s, (uint32_t)(val & 0xffffffff));
 242 }
 243
 244 void put_le16(ByteIOContext *s, unsigned int val)
 245 {
 246     put_byte(s, val);
 247     put_byte(s, val >> 8);
 248 }
 249
 250 void put_be16(ByteIOContext *s, unsigned int val)
 251 {
 252     put_byte(s, val >> 8);
 253     put_byte(s, val);
 254 }
 255
 256 void put_tag(ByteIOContext *s, const char *tag)
 257 {
 258     while (*tag) {
 259         put_byte(s, *tag++);
 260     }
 261 }
 262 #endif //CONFIG_ENCODERS
 263
 264 /* Input stream */
 265
 266 static void fill_buffer(ByteIOContext *s)
 267 {
 268     int len;
 269
 270     /* no need to do anything if EOF already reached */
 271     if (s->eof_reached)
 272         return;
 273
 274     if(s->update_checksum){
 275         if(s->buf_end > s->checksum_ptr)
 276             s->checksum= s->update_checksum(s->checksum, s->checksum_ptr, s->buf_end - s->checksum_ptr);
 277         s->checksum_ptr= s->buffer;
 278     }
 279
 280     len = s->read_packet(s->opaque, s->buffer, s->buffer_size);
 281     if (len <= 0) {
 282         /* do not modify buffer if EOF reached so that a seek back can
 283            be done without rereading data */
 284         s->eof_reached = 1;
 285     if(len<0)
 286         s->error= len;
 287     } else {
 288         s->pos += len;
 289         s->buf_ptr = s->buffer;
 290         s->buf_end = s->buffer + len;
 291     }
 292 }
 293
 294 unsigned long get_checksum(ByteIOContext *s){
 295     s->checksum= s->update_checksum(s->checksum, s->checksum_ptr, s->buf_ptr - s->checksum_ptr);
 296     s->update_checksum= NULL;
 297     return s->checksum;
 298 }
 299
 300 void init_checksum(ByteIOContext *s, unsigned long (*update_checksum)(unsigned long c, const uint8_t *p, unsigned int len), unsigned long checksum){
 301     s->update_checksum= update_checksum;
 302     if(s->update_checksum){
 303         s->checksum= s->update_checksum(checksum, NULL, 0);
 304         s->checksum_ptr= s->buf_ptr;
 305     }
 306 }
 307
 308 /* NOTE: return 0 if EOF, so you cannot use it if EOF handling is
 309    necessary */
 310 /* XXX: put an inline version */
 311 int get_byte(ByteIOContext *s)
 312 {
 313     if (s->buf_ptr < s->buf_end) {
 314         return *s->buf_ptr++;
 315     } else {
 316         fill_buffer(s);
 317         if (s->buf_ptr < s->buf_end)
 318             return *s->buf_ptr++;
 319         else
 320             return 0;
 321     }
 322 }
 323
 324 /* NOTE: return URL_EOF (-1) if EOF */
 325 int url_fgetc(ByteIOContext *s)
 326 {
 327     if (s->buf_ptr < s->buf_end) {
 328         return *s->buf_ptr++;
 329     } else {
 330         fill_buffer(s);
 331         if (s->buf_ptr < s->buf_end)
 332             return *s->buf_ptr++;
 333         else
 334             return URL_EOF;
 335     }
 336 }
 337
 338 int get_buffer(ByteIOContext *s, unsigned char *buf, int size)
 339 {
 340     int len, size1;
 341
 342     size1 = size;
 343     while (size > 0) {
 344         len = s->buf_end - s->buf_ptr;
 345         if (len > size)
 346             len = size;
 347         if (len == 0) {
 348             if(size > s->buffer_size && !s->update_checksum){
 349                 len = s->read_packet(s->opaque, buf, size);
 350                 if (len <= 0) {
 351                     /* do not modify buffer if EOF reached so that a seek back can
 352                     be done without rereading data */
 353                     s->eof_reached = 1;
 354                     if(len<0)
 355                         s->error= len;
 356                     break;
 357                 } else {
 358                     s->pos += len;
 359                     size -= len;
 360                     buf += len;
 361                     s->buf_ptr = s->buffer;
 362                     s->buf_end = s->buffer/* + len*/;
 363                 }
 364             }else{
 365                 fill_buffer(s);
 366                 len = s->buf_end - s->buf_ptr;
 367                 if (len == 0)
 368                     break;
 369             }
 370         } else {
 371             memcpy(buf, s->buf_ptr, len);
 372             buf += len;
 373             s->buf_ptr += len;
 374             size -= len;
 375         }
 376     }
 377     return size1 - size;
 378 }
 379
 380 int get_partial_buffer(ByteIOContext *s, unsigned char *buf, int size)
 381 {
 382     int len;
 383
 384     if(size<0)
 385         return -1;
 386
 387     len = s->buf_end - s->buf_ptr;
 388     if (len == 0) {
 389         fill_buffer(s);
 390         len = s->buf_end - s->buf_ptr;
 391     }
 392     if (len > size)
 393         len = size;
 394     memcpy(buf, s->buf_ptr, len);
 395     s->buf_ptr += len;
 396     return len;
 397 }
 398
 399 unsigned int get_le16(ByteIOContext *s)
 400 {
 401     unsigned int val;
 402     val = get_byte(s);
 403     val |= get_byte(s) << 8;
 404     return val;
 405 }
 406
 407 unsigned int get_le32(ByteIOContext *s)
 408 {
 409     unsigned int val;
 410     val = get_byte(s);
 411     val |= get_byte(s) << 8;
 412     val |= get_byte(s) << 16;
 413     val |= get_byte(s) << 24;
 414     return val;
 415 }
 416
 417 uint64_t get_le64(ByteIOContext *s)
 418 {
 419     uint64_t val;
 420     val = (uint64_t)get_le32(s);
 421     val |= (uint64_t)get_le32(s) << 32;
 422     return val;
 423 }
 424
 425 unsigned int get_be16(ByteIOContext *s)
 426 {
 427     unsigned int val;
 428     val = get_byte(s) << 8;
 429     val |= get_byte(s);
 430     return val;
 431 }
 432
 433 unsigned int get_be32(ByteIOContext *s)
 434 {
 435     unsigned int val;
 436     val = get_byte(s) << 24;
 437     val |= get_byte(s) << 16;
 438     val |= get_byte(s) << 8;
 439     val |= get_byte(s);
 440     return val;
 441 }
 442
 443 double get_be64_double(ByteIOContext *s)
 444 {
 445     union {
 446         double d;
 447         uint64_t ull;
 448     } u;
 449
 450     u.ull = get_be64(s);
 451     return u.d;
 452 }
 453
 454 char *get_strz(ByteIOContext *s, char *buf, int maxlen)
 455 {
 456     int i = 0;
 457     char c;
 458
 459     while ((c = get_byte(s))) {
 460         if (i < maxlen-1)
 461             buf[i++] = c;
 462     }
 463
 464     buf[i] = 0; /* Ensure null terminated, but may be truncated */
 465
 466     return buf;
 467 }
 468
 469 uint64_t get_be64(ByteIOContext *s)
 470 {
 471     uint64_t val;
 472     val = (uint64_t)get_be32(s) << 32;
 473     val |= (uint64_t)get_be32(s);
 474     return val;
 475 }
 476
 477 /* link with avio functions */
 478
 479 #ifdef CONFIG_ENCODERS
 480 static int url_write_packet(void *opaque, uint8_t *buf, int buf_size)
 481 {
 482     URLContext *h = opaque;
 483     return url_write(h, buf, buf_size);
 484 }
 485 #else
 486 #define url_write_packet NULL
 487 #endif //CONFIG_ENCODERS
 488
 489 static int url_read_packet(void *opaque, uint8_t *buf, int buf_size)
 490 {
 491     URLContext *h = opaque;
 492     return url_read(h, buf, buf_size);
 493 }
 494
 495 static offset_t url_seek_packet(void *opaque, offset_t offset, int whence)
 496 {
 497     URLContext *h = opaque;
 498     return url_seek(h, offset, whence);
 499     //return 0;
 500 }
 501
 502 int url_fdopen(ByteIOContext *s, URLContext *h)
 503 {
 504     uint8_t *buffer;
 505     int buffer_size, max_packet_size;
 506
 507
 508     max_packet_size = url_get_max_packet_size(h);
 509     if (max_packet_size) {
 510         buffer_size = max_packet_size; /* no need to bufferize more than one packet */
 511     } else {
 512         buffer_size = IO_BUFFER_SIZE;
 513     }
 514     buffer = av_malloc(buffer_size);
 515     if (!buffer)
 516         return -ENOMEM;
 517
 518     if (init_put_byte(s, buffer, buffer_size,
 519                       (h->flags & URL_WRONLY || h->flags & URL_RDWR), h,
 520                       url_read_packet, url_write_packet, url_seek_packet) < 0) {
 521         av_free(buffer);
 522         return AVERROR_IO;
 523     }
 524     s->is_streamed = h->is_streamed;
 525     s->max_packet_size = max_packet_size;
 526     return 0;
 527 }
 528
 529 /* XXX: must be called before any I/O */
 530 int url_setbufsize(ByteIOContext *s, int buf_size)
 531 {
 532     uint8_t *buffer;
 533     buffer = av_malloc(buf_size);
 534     if (!buffer)
 535         return -ENOMEM;
 536
 537     av_free(s->buffer);
 538     s->buffer = buffer;
 539     s->buffer_size = buf_size;
 540     s->buf_ptr = buffer;
 541     if (!s->write_flag)
 542         s->buf_end = buffer;
 543     else
 544         s->buf_end = buffer + buf_size;
 545     return 0;
 546 }
 547
 548 /* NOTE: when opened as read/write, the buffers are only used for
 549    reading */
 550 int url_fopen(ByteIOContext *s, const char *filename, int flags)
 551 {
 552     URLContext *h;
 553     int err;
 554
 555     err = url_open(&h, filename, flags);
 556     if (err < 0)
 557         return err;
 558     err = url_fdopen(s, h);
 559     if (err < 0) {
 560         url_close(h);
 561         return err;
 562     }
 563     return 0;
 564 }
 565
 566 int url_fclose(ByteIOContext *s)
 567 {
 568     URLContext *h = s->opaque;
 569
 570     av_free(s->buffer);
 571     memset(s, 0, sizeof(ByteIOContext));
 572     return url_close(h);
 573 }
 574
 575 URLContext *url_fileno(ByteIOContext *s)
 576 {
 577     return s->opaque;
 578 }
 579
 580 #ifdef CONFIG_ENCODERS
 581 /* XXX: currently size is limited */
 582 int url_fprintf(ByteIOContext *s, const char *fmt, ...)
 583 {
 584     va_list ap;
 585     char buf[4096];
 586     int ret;
 587
 588     va_start(ap, fmt);
 589     ret = vsnprintf(buf, sizeof(buf), fmt, ap);
 590     va_end(ap);
 591     put_buffer(s, buf, strlen(buf));
 592     return ret;
 593 }
 594 #endif //CONFIG_ENCODERS
 595
 596 /* note: unlike fgets, the EOL character is not returned and a whole
 597    line is parsed. return NULL if first char read was EOF */
 598 char *url_fgets(ByteIOContext *s, char *buf, int buf_size)
 599 {
 600     int c;
 601     char *q;
 602
 603     c = url_fgetc(s);
 604     if (c == EOF)
 605         return NULL;
 606     q = buf;
 607     for(;;) {
 608         if (c == EOF || c == '\n')
 609             break;
 610         if ((q - buf) < buf_size - 1)
 611             *q++ = c;
 612         c = url_fgetc(s);
 613     }
 614     if (buf_size > 0)
 615         *q = '\0';
 616     return buf;
 617 }
 618
 619 /*
 620  * Return the maximum packet size associated to packetized buffered file
 621  * handle. If the file is not packetized (stream like http or file on
 622  * disk), then 0 is returned.
 623  *
 624  * @param h buffered file handle
 625  * @return maximum packet size in bytes
 626  */
 627 int url_fget_max_packet_size(ByteIOContext *s)
 628 {
 629     return s->max_packet_size;
 630 }
 631
 632 #ifdef CONFIG_ENCODERS
 633 /* buffer handling */
 634 int url_open_buf(ByteIOContext *s, uint8_t *buf, int buf_size, int flags)
 635 {
 636     return init_put_byte(s, buf, buf_size,
 637                          (flags & URL_WRONLY || flags & URL_RDWR),
 638                          NULL, NULL, NULL, NULL);
 639 }
 640
 641 /* return the written or read size */
 642 int url_close_buf(ByteIOContext *s)
 643 {
 644     put_flush_packet(s);
 645     return s->buf_ptr - s->buffer;
 646 }
 647
 648 /* output in a dynamic buffer */
 649
 650 typedef struct DynBuffer {
 651     int pos, size, allocated_size;
 652     uint8_t *buffer;
 653     int io_buffer_size;
 654     uint8_t io_buffer[1];
 655 } DynBuffer;
 656
 657 static int dyn_buf_write(void *opaque, uint8_t *buf, int buf_size)
 658 {
 659     DynBuffer *d = opaque;
 660     int new_size, new_allocated_size;
 661
 662     /* reallocate buffer if needed */
 663     new_size = d->pos + buf_size;
 664     new_allocated_size = d->allocated_size;
 665     if(new_size < d->pos || new_size > INT_MAX/2)
 666         return -1;
 667     while (new_size > new_allocated_size) {
 668         if (!new_allocated_size)
 669             new_allocated_size = new_size;
 670         else
 671             new_allocated_size += new_allocated_size / 2 + 1;
 672     }
 673
 674     if (new_allocated_size > d->allocated_size) {
 675         d->buffer = av_realloc(d->buffer, new_allocated_size);
 676         if(d->buffer == NULL)
 677              return -1234;
 678         d->allocated_size = new_allocated_size;
 679     }
 680     memcpy(d->buffer + d->pos, buf, buf_size);
 681     d->pos = new_size;
 682     if (d->pos > d->size)
 683         d->size = d->pos;
 684     return buf_size;
 685 }
 686
 687 static int dyn_packet_buf_write(void *opaque, uint8_t *buf, int buf_size)
 688 {
 689     unsigned char buf1[4];
 690     int ret;
 691
 692     /* packetized write: output the header */
 693     buf1[0] = (buf_size >> 24);
 694     buf1[1] = (buf_size >> 16);
 695     buf1[2] = (buf_size >> 8);
 696     buf1[3] = (buf_size);
 697     ret= dyn_buf_write(opaque, buf1, 4);
 698     if(ret < 0)
 699         return ret;
 700
 701     /* then the data */
 702     return dyn_buf_write(opaque, buf, buf_size);
 703 }
 704
 705 static offset_t dyn_buf_seek(void *opaque, offset_t offset, int whence)
 706 {
 707     DynBuffer *d = opaque;
 708
 709     if (whence == SEEK_CUR)
 710         offset += d->pos;
 711     else if (whence == SEEK_END)
 712         offset += d->size;
 713     if (offset < 0 || offset > 0x7fffffffLL)
 714         return -1;
 715     d->pos = offset;
 716     return 0;
 717 }
 718
 719 static int url_open_dyn_buf_internal(ByteIOContext *s, int max_packet_size)
 720 {
 721     DynBuffer *d;
 722     int io_buffer_size, ret;
 723
 724     if (max_packet_size)
 725         io_buffer_size = max_packet_size;
 726     else
 727         io_buffer_size = 1024;
 728
 729     if(sizeof(DynBuffer) + io_buffer_size < io_buffer_size)
 730         return -1;
 731     d = av_malloc(sizeof(DynBuffer) + io_buffer_size);
 732     if (!d)
 733         return -1;
 734     d->io_buffer_size = io_buffer_size;
 735     d->buffer = NULL;
 736     d->pos = 0;
 737     d->size = 0;
 738     d->allocated_size = 0;
 739     ret = init_put_byte(s, d->io_buffer, io_buffer_size,
 740                         1, d, NULL,
 741                         max_packet_size ? dyn_packet_buf_write : dyn_buf_write,
 742                         max_packet_size ? NULL : dyn_buf_seek);
 743     if (ret == 0) {
 744         s->max_packet_size = max_packet_size;
 745     }
 746     return ret;
 747 }
 748
 749 /*
 750  * Open a write only memory stream.
 751  *
 752  * @param s new IO context
 753  * @return zero if no error.
 754  */
 755 int url_open_dyn_buf(ByteIOContext *s)
 756 {
 757     return url_open_dyn_buf_internal(s, 0);
 758 }
 759
 760 /*
 761  * Open a write only packetized memory stream with a maximum packet
 762  * size of 'max_packet_size'.  The stream is stored in a memory buffer
 763  * with a big endian 4 byte header giving the packet size in bytes.
 764  *
 765  * @param s new IO context
 766  * @param max_packet_size maximum packet size (must be > 0)
 767  * @return zero if no error.
 768  */
 769 int url_open_dyn_packet_buf(ByteIOContext *s, int max_packet_size)
 770 {
 771     if (max_packet_size <= 0)
 772         return -1;
 773     return url_open_dyn_buf_internal(s, max_packet_size);
 774 }
 775
 776 /*
 777  * Return the written size and a pointer to the buffer. The buffer
 778  *  must be freed with av_free().
 779  * @param s IO context
 780  * @param pointer to a byte buffer
 781  * @return the length of the byte buffer
 782  */
 783 int url_close_dyn_buf(ByteIOContext *s, uint8_t **pbuffer)
 784 {
 785     DynBuffer *d = s->opaque;
 786     int size;
 787
 788     put_flush_packet(s);
 789
 790     *pbuffer = d->buffer;
 791     size = d->size;
 792     av_free(d);
 793     return size;
 794 }
 795 #endif //CONFIG_ENCODERS