2 * Buffered I/O for ffmpeg system
3 * Copyright (c) 2000,2001 Fabrice Bellard
5 * This file is part of Libav.
7 * Libav is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * Libav is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with Libav; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 #include "libavutil/crc.h"
23 #include "libavutil/intreadwrite.h"
26 #include "avio_internal.h"
30 #define IO_BUFFER_SIZE 32768
33 * Do seeks within this distance ahead of the current buffer by skipping
34 * data instead of calling the protocol seek function, for seekable
37 #define SHORT_SEEK_THRESHOLD 4096
39 static void fill_buffer(AVIOContext *s);
40 #if !FF_API_URL_RESETBUF
41 static int url_resetbuf(AVIOContext *s, int flags);
44 int ffio_init_context(AVIOContext *s,
45 unsigned char *buffer,
49 int (*read_packet)(void *opaque, uint8_t *buf, int buf_size),
50 int (*write_packet)(void *opaque, uint8_t *buf, int buf_size),
51 int64_t (*seek)(void *opaque, int64_t offset, int whence))
54 s->buffer_size = buffer_size;
57 url_resetbuf(s, write_flag ? URL_WRONLY : URL_RDONLY);
58 s->write_packet = write_packet;
59 s->read_packet = read_packet;
66 s->max_packet_size = 0;
67 s->update_checksum= NULL;
68 if(!read_packet && !write_flag){
70 s->buf_end = s->buffer + buffer_size;
78 int init_put_byte(AVIOContext *s,
79 unsigned char *buffer,
83 int (*read_packet)(void *opaque, uint8_t *buf, int buf_size),
84 int (*write_packet)(void *opaque, uint8_t *buf, int buf_size),
85 int64_t (*seek)(void *opaque, int64_t offset, int whence))
87 return ffio_init_context(s, buffer, buffer_size, write_flag, opaque,
88 read_packet, write_packet, seek);
90 AVIOContext *av_alloc_put_byte(
91 unsigned char *buffer,
95 int (*read_packet)(void *opaque, uint8_t *buf, int buf_size),
96 int (*write_packet)(void *opaque, uint8_t *buf, int buf_size),
97 int64_t (*seek)(void *opaque, int64_t offset, int whence))
99 return avio_alloc_context(buffer, buffer_size, write_flag, opaque,
100 read_packet, write_packet, seek);
104 AVIOContext *avio_alloc_context(
105 unsigned char *buffer,
109 int (*read_packet)(void *opaque, uint8_t *buf, int buf_size),
110 int (*write_packet)(void *opaque, uint8_t *buf, int buf_size),
111 int64_t (*seek)(void *opaque, int64_t offset, int whence))
113 AVIOContext *s = av_mallocz(sizeof(AVIOContext));
114 ffio_init_context(s, buffer, buffer_size, write_flag, opaque,
115 read_packet, write_packet, seek);
119 static void flush_buffer(AVIOContext *s)
121 if (s->buf_ptr > s->buffer) {
122 if (s->write_packet && !s->error){
123 int ret= s->write_packet(s->opaque, s->buffer, s->buf_ptr - s->buffer);
128 if(s->update_checksum){
129 s->checksum= s->update_checksum(s->checksum, s->checksum_ptr, s->buf_ptr - s->checksum_ptr);
130 s->checksum_ptr= s->buffer;
132 s->pos += s->buf_ptr - s->buffer;
134 s->buf_ptr = s->buffer;
137 void avio_w8(AVIOContext *s, int b)
140 if (s->buf_ptr >= s->buf_end)
144 void ffio_fill(AVIOContext *s, int b, int count)
147 int len = FFMIN(s->buf_end - s->buf_ptr, count);
148 memset(s->buf_ptr, b, len);
151 if (s->buf_ptr >= s->buf_end)
158 void avio_write(AVIOContext *s, const unsigned char *buf, int size)
161 int len = FFMIN(s->buf_end - s->buf_ptr, size);
162 memcpy(s->buf_ptr, buf, len);
165 if (s->buf_ptr >= s->buf_end)
173 void avio_flush(AVIOContext *s)
179 int64_t avio_seek(AVIOContext *s, int64_t offset, int whence)
183 int force = whence & AVSEEK_FORCE;
184 whence &= ~AVSEEK_FORCE;
187 return AVERROR(EINVAL);
189 pos = s->pos - (s->write_flag ? 0 : (s->buf_end - s->buffer));
191 if (whence != SEEK_CUR && whence != SEEK_SET)
192 return AVERROR(EINVAL);
194 if (whence == SEEK_CUR) {
195 offset1 = pos + (s->buf_ptr - s->buffer);
200 offset1 = offset - pos;
201 if (!s->must_flush &&
202 offset1 >= 0 && offset1 <= (s->buf_end - s->buffer)) {
203 /* can do the seek inside the buffer */
204 s->buf_ptr = s->buffer + offset1;
205 } else if ((s->is_streamed ||
206 offset1 <= s->buf_end + SHORT_SEEK_THRESHOLD - s->buffer) &&
207 !s->write_flag && offset1 >= 0 &&
208 (whence != SEEK_END || force)) {
209 while(s->pos < offset && !s->eof_reached)
213 s->buf_ptr = s->buf_end + offset - s->pos;
217 #if CONFIG_MUXERS || CONFIG_NETWORK
222 #endif /* CONFIG_MUXERS || CONFIG_NETWORK */
224 return AVERROR(EPIPE);
225 if ((res = s->seek(s->opaque, offset, SEEK_SET)) < 0)
228 s->buf_end = s->buffer;
229 s->buf_ptr = s->buffer;
237 int url_fskip(AVIOContext *s, int64_t offset)
239 int64_t ret = avio_seek(s, offset, SEEK_CUR);
240 return ret < 0 ? ret : 0;
243 int64_t url_ftell(AVIOContext *s)
245 return avio_seek(s, 0, SEEK_CUR);
249 int64_t avio_size(AVIOContext *s)
254 return AVERROR(EINVAL);
257 return AVERROR(ENOSYS);
258 size = s->seek(s->opaque, 0, AVSEEK_SIZE);
260 if ((size = s->seek(s->opaque, -1, SEEK_END)) < 0)
263 s->seek(s->opaque, s->pos, SEEK_SET);
269 int url_feof(AVIOContext *s)
273 return s->eof_reached;
276 int url_ferror(AVIOContext *s)
284 void avio_wl32(AVIOContext *s, unsigned int val)
287 avio_w8(s, val >> 8);
288 avio_w8(s, val >> 16);
289 avio_w8(s, val >> 24);
292 void avio_wb32(AVIOContext *s, unsigned int val)
294 avio_w8(s, val >> 24);
295 avio_w8(s, val >> 16);
296 avio_w8(s, val >> 8);
301 void put_strz(AVIOContext *s, const char *str)
303 avio_put_str(s, str);
306 #define GET(name, type) \
307 type get_be ##name(AVIOContext *s) \
309 return avio_rb ##name(s);\
311 type get_le ##name(AVIOContext *s) \
313 return avio_rl ##name(s);\
316 GET(16, unsigned int)
317 GET(24, unsigned int)
318 GET(32, unsigned int)
323 #define PUT(name, type ) \
324 void put_le ##name(AVIOContext *s, type val)\
326 avio_wl ##name(s, val);\
328 void put_be ##name(AVIOContext *s, type val)\
330 avio_wb ##name(s, val);\
333 PUT(16, unsigned int)
334 PUT(24, unsigned int)
335 PUT(32, unsigned int)
339 int get_byte(AVIOContext *s)
343 int get_buffer(AVIOContext *s, unsigned char *buf, int size)
345 return avio_read(s, buf, size);
347 int get_partial_buffer(AVIOContext *s, unsigned char *buf, int size)
349 return ffio_read_partial(s, buf, size);
351 void put_byte(AVIOContext *s, int val)
355 void put_buffer(AVIOContext *s, const unsigned char *buf, int size)
357 avio_write(s, buf, size);
359 void put_nbyte(AVIOContext *s, int b, int count)
361 ffio_fill(s, b, count);
364 int url_fopen(AVIOContext **s, const char *filename, int flags)
366 return avio_open(s, filename, flags);
368 int url_fclose(AVIOContext *s)
370 return avio_close(s);
372 int64_t url_fseek(AVIOContext *s, int64_t offset, int whence)
374 return avio_seek(s, offset, whence);
376 int64_t url_fsize(AVIOContext *s)
380 int url_setbufsize(AVIOContext *s, int buf_size)
382 return ffio_set_buf_size(s, buf_size);
384 int url_fprintf(AVIOContext *s, const char *fmt, ...)
391 ret = vsnprintf(buf, sizeof(buf), fmt, ap);
393 avio_write(s, buf, strlen(buf));
396 void put_flush_packet(AVIOContext *s)
400 int av_url_read_fpause(AVIOContext *s, int pause)
402 return ffio_read_pause(s, pause);
404 int64_t av_url_read_fseek(AVIOContext *s, int stream_index,
405 int64_t timestamp, int flags)
407 return ffio_read_seek(s, stream_index, timestamp, flags);
411 int avio_put_str(AVIOContext *s, const char *str)
416 avio_write(s, (const unsigned char *) str, len);
422 int avio_put_str16le(AVIOContext *s, const char *str)
424 const uint8_t *q = str;
431 GET_UTF8(ch, *q++, break;)
432 PUT_UTF16(ch, tmp, avio_wl16(s, tmp);ret += 2;)
439 int ff_get_v_length(uint64_t val){
448 void ff_put_v(AVIOContext *bc, uint64_t val){
449 int i= ff_get_v_length(val);
452 avio_w8(bc, 128 | (val>>(7*i)));
454 avio_w8(bc, val&127);
457 void avio_wl64(AVIOContext *s, uint64_t val)
459 avio_wl32(s, (uint32_t)(val & 0xffffffff));
460 avio_wl32(s, (uint32_t)(val >> 32));
463 void avio_wb64(AVIOContext *s, uint64_t val)
465 avio_wb32(s, (uint32_t)(val >> 32));
466 avio_wb32(s, (uint32_t)(val & 0xffffffff));
469 void avio_wl16(AVIOContext *s, unsigned int val)
472 avio_w8(s, val >> 8);
475 void avio_wb16(AVIOContext *s, unsigned int val)
477 avio_w8(s, val >> 8);
481 void avio_wl24(AVIOContext *s, unsigned int val)
483 avio_wl16(s, val & 0xffff);
484 avio_w8(s, val >> 16);
487 void avio_wb24(AVIOContext *s, unsigned int val)
489 avio_wb16(s, val >> 8);
494 void put_tag(AVIOContext *s, const char *tag)
504 static void fill_buffer(AVIOContext *s)
506 uint8_t *dst= !s->max_packet_size && s->buf_end - s->buffer < s->buffer_size ? s->buf_end : s->buffer;
507 int len= s->buffer_size - (dst - s->buffer);
508 int max_buffer_size = s->max_packet_size ? s->max_packet_size : IO_BUFFER_SIZE;
510 /* no need to do anything if EOF already reached */
514 if(s->update_checksum && dst == s->buffer){
515 if(s->buf_end > s->checksum_ptr)
516 s->checksum= s->update_checksum(s->checksum, s->checksum_ptr, s->buf_end - s->checksum_ptr);
517 s->checksum_ptr= s->buffer;
520 /* make buffer smaller in case it ended up large after probing */
521 if (s->buffer_size > max_buffer_size) {
522 ffio_set_buf_size(s, max_buffer_size);
524 s->checksum_ptr = dst = s->buffer;
525 len = s->buffer_size;
529 len = s->read_packet(s->opaque, dst, len);
533 /* do not modify buffer if EOF reached so that a seek back can
534 be done without rereading data */
541 s->buf_end = dst + len;
545 unsigned long ff_crc04C11DB7_update(unsigned long checksum, const uint8_t *buf,
548 return av_crc(av_crc_get_table(AV_CRC_32_IEEE), checksum, buf, len);
551 unsigned long get_checksum(AVIOContext *s)
553 s->checksum= s->update_checksum(s->checksum, s->checksum_ptr, s->buf_ptr - s->checksum_ptr);
554 s->update_checksum= NULL;
558 void init_checksum(AVIOContext *s,
559 unsigned long (*update_checksum)(unsigned long c, const uint8_t *p, unsigned int len),
560 unsigned long checksum)
562 s->update_checksum= update_checksum;
563 if(s->update_checksum){
564 s->checksum= checksum;
565 s->checksum_ptr= s->buf_ptr;
569 /* XXX: put an inline version */
570 int avio_r8(AVIOContext *s)
572 if (s->buf_ptr >= s->buf_end)
574 if (s->buf_ptr < s->buf_end)
575 return *s->buf_ptr++;
580 int url_fgetc(AVIOContext *s)
582 if (s->buf_ptr >= s->buf_end)
584 if (s->buf_ptr < s->buf_end)
585 return *s->buf_ptr++;
590 int avio_read(AVIOContext *s, unsigned char *buf, int size)
596 len = s->buf_end - s->buf_ptr;
600 if(size > s->buffer_size && !s->update_checksum){
602 len = s->read_packet(s->opaque, buf, size);
604 /* do not modify buffer if EOF reached so that a seek back can
605 be done without rereading data */
614 s->buf_ptr = s->buffer;
615 s->buf_end = s->buffer/* + len*/;
619 len = s->buf_end - s->buf_ptr;
624 memcpy(buf, s->buf_ptr, len);
631 if (s->error) return s->error;
632 if (s->eof_reached) return AVERROR_EOF;
637 int ffio_read_partial(AVIOContext *s, unsigned char *buf, int size)
644 len = s->buf_end - s->buf_ptr;
647 len = s->buf_end - s->buf_ptr;
651 memcpy(buf, s->buf_ptr, len);
654 if (s->error) return s->error;
655 if (s->eof_reached) return AVERROR_EOF;
660 unsigned int avio_rl16(AVIOContext *s)
664 val |= avio_r8(s) << 8;
668 unsigned int avio_rl24(AVIOContext *s)
672 val |= avio_r8(s) << 16;
676 unsigned int avio_rl32(AVIOContext *s)
680 val |= avio_rl16(s) << 16;
684 uint64_t avio_rl64(AVIOContext *s)
687 val = (uint64_t)avio_rl32(s);
688 val |= (uint64_t)avio_rl32(s) << 32;
692 unsigned int avio_rb16(AVIOContext *s)
695 val = avio_r8(s) << 8;
700 unsigned int avio_rb24(AVIOContext *s)
703 val = avio_rb16(s) << 8;
707 unsigned int avio_rb32(AVIOContext *s)
710 val = avio_rb16(s) << 16;
716 char *get_strz(AVIOContext *s, char *buf, int maxlen)
718 avio_get_str(s, INT_MAX, buf, maxlen);
723 int ff_get_line(AVIOContext *s, char *buf, int maxlen)
730 if (c && i < maxlen-1)
732 } while (c != '\n' && c);
738 int avio_get_str(AVIOContext *s, int maxlen, char *buf, int buflen)
742 // reserve 1 byte for terminating 0
743 buflen = FFMIN(buflen - 1, maxlen);
744 for (i = 0; i < buflen; i++)
745 if (!(buf[i] = avio_r8(s)))
749 for (; i < maxlen; i++)
755 #define GET_STR16(type, read) \
756 int avio_get_str16 ##type(AVIOContext *pb, int maxlen, char *buf, int buflen)\
760 while (ret + 1 < maxlen) {\
763 GET_UTF16(ch, (ret += 2) <= maxlen ? read(pb) : 0, break;)\
766 PUT_UTF8(ch, tmp, if (q - buf < buflen - 1) *q++ = tmp;)\
772 GET_STR16(le, avio_rl16)
773 GET_STR16(be, avio_rb16)
777 uint64_t avio_rb64(AVIOContext *s)
780 val = (uint64_t)avio_rb32(s) << 32;
781 val |= (uint64_t)avio_rb32(s);
785 uint64_t ffio_read_varlen(AVIOContext *bc){
791 val= (val<<7) + (tmp&127);
796 int url_fdopen(AVIOContext **s, URLContext *h)
799 int buffer_size, max_packet_size;
801 max_packet_size = url_get_max_packet_size(h);
802 if (max_packet_size) {
803 buffer_size = max_packet_size; /* no need to bufferize more than one packet */
805 buffer_size = IO_BUFFER_SIZE;
807 buffer = av_malloc(buffer_size);
809 return AVERROR(ENOMEM);
811 *s = av_mallocz(sizeof(AVIOContext));
814 return AVERROR(ENOMEM);
817 if (ffio_init_context(*s, buffer, buffer_size,
818 (h->flags & URL_WRONLY || h->flags & URL_RDWR), h,
819 url_read, url_write, url_seek) < 0) {
824 (*s)->is_streamed = h->is_streamed;
825 (*s)->max_packet_size = max_packet_size;
827 (*s)->read_pause = (int (*)(void *, int))h->prot->url_read_pause;
828 (*s)->read_seek = (int64_t (*)(void *, int, int64_t, int))h->prot->url_read_seek;
833 int ffio_set_buf_size(AVIOContext *s, int buf_size)
836 buffer = av_malloc(buf_size);
838 return AVERROR(ENOMEM);
842 s->buffer_size = buf_size;
844 url_resetbuf(s, s->write_flag ? URL_WRONLY : URL_RDONLY);
848 #if FF_API_URL_RESETBUF
849 int url_resetbuf(AVIOContext *s, int flags)
851 static int url_resetbuf(AVIOContext *s, int flags)
854 #if FF_API_URL_RESETBUF
855 if (flags & URL_RDWR)
856 return AVERROR(EINVAL);
858 assert(flags == URL_WRONLY || flags == URL_RDONLY);
861 if (flags & URL_WRONLY) {
862 s->buf_end = s->buffer + s->buffer_size;
865 s->buf_end = s->buffer;
871 int ffio_rewind_with_probe_data(AVIOContext *s, unsigned char *buf, int buf_size)
873 int64_t buffer_start;
875 int overlap, new_size, alloc_size;
878 return AVERROR(EINVAL);
880 buffer_size = s->buf_end - s->buffer;
882 /* the buffers must touch or overlap */
883 if ((buffer_start = s->pos - buffer_size) > buf_size)
884 return AVERROR(EINVAL);
886 overlap = buf_size - buffer_start;
887 new_size = buf_size + buffer_size - overlap;
889 alloc_size = FFMAX(s->buffer_size, new_size);
890 if (alloc_size > buf_size)
891 if (!(buf = av_realloc(buf, alloc_size)))
892 return AVERROR(ENOMEM);
894 if (new_size > buf_size) {
895 memcpy(buf + buf_size, s->buffer + overlap, buffer_size - overlap);
900 s->buf_ptr = s->buffer = buf;
901 s->buffer_size = alloc_size;
903 s->buf_end = s->buf_ptr + buf_size;
910 int avio_open(AVIOContext **s, const char *filename, int flags)
915 err = url_open(&h, filename, flags);
918 err = url_fdopen(s, h);
926 int avio_close(AVIOContext *s)
928 URLContext *h = s->opaque;
936 URLContext *url_fileno(AVIOContext *s)
942 int avio_printf(AVIOContext *s, const char *fmt, ...)
949 ret = vsnprintf(buf, sizeof(buf), fmt, ap);
951 avio_write(s, buf, strlen(buf));
956 char *url_fgets(AVIOContext *s, char *buf, int buf_size)
966 if (s->eof_reached || c == '\n')
968 if ((q - buf) < buf_size - 1)
977 int url_fget_max_packet_size(AVIOContext *s)
979 return s->max_packet_size;
983 int ffio_read_pause(AVIOContext *s, int pause)
986 return AVERROR(ENOSYS);
987 return s->read_pause(s->opaque, pause);
990 int64_t ffio_read_seek(AVIOContext *s, int stream_index,
991 int64_t timestamp, int flags)
993 URLContext *h = s->opaque;
996 return AVERROR(ENOSYS);
997 ret = s->read_seek(h, stream_index, timestamp, flags);
1000 s->buf_ptr = s->buf_end; // Flush buffer
1001 pos = s->seek(h, 0, SEEK_CUR);
1004 else if (pos != AVERROR(ENOSYS))
1010 /* url_open_dyn_buf and url_close_dyn_buf are used in rtp.c to send a response
1011 * back to the server even if CONFIG_MUXERS is false. */
1012 #if CONFIG_MUXERS || CONFIG_NETWORK
1013 /* buffer handling */
1015 int url_open_buf(AVIOContext **s, uint8_t *buf, int buf_size, int flags)
1018 *s = av_mallocz(sizeof(AVIOContext));
1020 return AVERROR(ENOMEM);
1021 ret = ffio_init_context(*s, buf, buf_size,
1022 (flags & URL_WRONLY || flags & URL_RDWR),
1023 NULL, NULL, NULL, NULL);
1029 int url_close_buf(AVIOContext *s)
1032 return s->buf_ptr - s->buffer;
1036 /* output in a dynamic buffer */
1038 typedef struct DynBuffer {
1039 int pos, size, allocated_size;
1042 uint8_t io_buffer[1];
1045 static int dyn_buf_write(void *opaque, uint8_t *buf, int buf_size)
1047 DynBuffer *d = opaque;
1048 unsigned new_size, new_allocated_size;
1050 /* reallocate buffer if needed */
1051 new_size = d->pos + buf_size;
1052 new_allocated_size = d->allocated_size;
1053 if(new_size < d->pos || new_size > INT_MAX/2)
1055 while (new_size > new_allocated_size) {
1056 if (!new_allocated_size)
1057 new_allocated_size = new_size;
1059 new_allocated_size += new_allocated_size / 2 + 1;
1062 if (new_allocated_size > d->allocated_size) {
1063 d->buffer = av_realloc(d->buffer, new_allocated_size);
1064 if(d->buffer == NULL)
1065 return AVERROR(ENOMEM);
1066 d->allocated_size = new_allocated_size;
1068 memcpy(d->buffer + d->pos, buf, buf_size);
1070 if (d->pos > d->size)
1075 static int dyn_packet_buf_write(void *opaque, uint8_t *buf, int buf_size)
1077 unsigned char buf1[4];
1080 /* packetized write: output the header */
1081 AV_WB32(buf1, buf_size);
1082 ret= dyn_buf_write(opaque, buf1, 4);
1087 return dyn_buf_write(opaque, buf, buf_size);
1090 static int64_t dyn_buf_seek(void *opaque, int64_t offset, int whence)
1092 DynBuffer *d = opaque;
1094 if (whence == SEEK_CUR)
1096 else if (whence == SEEK_END)
1098 if (offset < 0 || offset > 0x7fffffffLL)
1104 static int url_open_dyn_buf_internal(AVIOContext **s, int max_packet_size)
1108 unsigned io_buffer_size = max_packet_size ? max_packet_size : 1024;
1110 if(sizeof(DynBuffer) + io_buffer_size < io_buffer_size)
1112 d = av_mallocz(sizeof(DynBuffer) + io_buffer_size);
1114 return AVERROR(ENOMEM);
1115 *s = av_mallocz(sizeof(AVIOContext));
1118 return AVERROR(ENOMEM);
1120 d->io_buffer_size = io_buffer_size;
1121 ret = ffio_init_context(*s, d->io_buffer, io_buffer_size,
1123 max_packet_size ? dyn_packet_buf_write : dyn_buf_write,
1124 max_packet_size ? NULL : dyn_buf_seek);
1126 (*s)->max_packet_size = max_packet_size;
1134 int url_open_dyn_buf(AVIOContext **s)
1136 return url_open_dyn_buf_internal(s, 0);
1139 int url_open_dyn_packet_buf(AVIOContext **s, int max_packet_size)
1141 if (max_packet_size <= 0)
1143 return url_open_dyn_buf_internal(s, max_packet_size);
1146 int url_close_dyn_buf(AVIOContext *s, uint8_t **pbuffer)
1148 DynBuffer *d = s->opaque;
1150 static const char padbuf[FF_INPUT_BUFFER_PADDING_SIZE] = {0};
1153 /* don't attempt to pad fixed-size packet buffers */
1154 if (!s->max_packet_size) {
1155 avio_write(s, padbuf, sizeof(padbuf));
1156 padding = FF_INPUT_BUFFER_PADDING_SIZE;
1161 *pbuffer = d->buffer;
1165 return size - padding;
1167 #endif /* CONFIG_MUXERS || CONFIG_NETWORK */