segment.c 19.3 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
/*
 * Copyright (c) 2011, Luca Barbato
 *
 * This file is part of Libav.
 *
 * Libav is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * Libav is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with Libav; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

21 22
/**
 * @file generic segmenter
23 24
 * M3U8 specification can be find here:
 * @url{http://tools.ietf.org/id/draft-pantos-http-live-streaming-08.txt}
25 26
 */

27 28 29 30 31
#include <float.h>

#include "avformat.h"
#include "internal.h"

32
#include "libavutil/avassert.h"
33 34 35 36 37 38
#include "libavutil/log.h"
#include "libavutil/opt.h"
#include "libavutil/avstring.h"
#include "libavutil/parseutils.h"
#include "libavutil/mathematics.h"

39
typedef enum {
40
    LIST_TYPE_UNDEFINED = -1,
41
    LIST_TYPE_FLAT = 0,
42
    LIST_TYPE_CSV,
43
    LIST_TYPE_M3U8,
44
    LIST_TYPE_EXT, ///< deprecated
45 46 47
    LIST_TYPE_NB,
} ListType;

48

49 50 51
#define SEGMENT_LIST_FLAG_CACHE 1
#define SEGMENT_LIST_FLAG_LIVE  2

52 53
typedef struct {
    const AVClass *class;  /**< Class for private options. */
54 55 56
    int segment_idx;       ///< index of the segment file to write, starting from 0
    int segment_idx_wrap;  ///< number after which the index wraps
    int segment_count;     ///< number of segment files already written
57
    AVOutputFormat *oformat;
58
    AVFormatContext *avf;
59 60
    char *format;          ///< format to use for output segment files
    char *list;            ///< filename for the segment list file
61
    int   list_count;      ///< list counter
62
    int   list_flags;      ///< flags affecting list generation
63
    int   list_size;       ///< number of entries for the segment list file
64
    double list_max_segment_time; ///< max segment time in the current list
65
    ListType list_type;    ///< set the list type
66
    AVIOContext *list_pb;  ///< list file put-byte context
67 68
    char *time_str;        ///< segment duration specification string
    int64_t time;          ///< segment duration
69 70 71
    char *times_str;       ///< segment times specification string
    int64_t *times;        ///< list of segment interval specification
    int nb_times;          ///< number of elments in the times array
72 73
    char *time_delta_str;  ///< approximation value duration used for the segment times
    int64_t time_delta;
74
    int  individual_header_trailer; /**< Set by a private option. */
75
    int  write_header_trailer; /**< Set by a private option. */
76
    int has_video;
77
    double start_time, end_time;
78 79
} SegmentContext;

80 81
static void print_csv_escaped_str(AVIOContext *ctx, const char *str)
{
82
    int needs_quoting = !!str[strcspn(str, "\",\n\r")];
83

84
    if (needs_quoting)
85 86
        avio_w8(ctx, '"');

87 88
    for (; *str; str++) {
        if (*str == '"')
89
            avio_w8(ctx, '"');
90
        avio_w8(ctx, *str);
91
    }
92
    if (needs_quoting)
93 94 95
        avio_w8(ctx, '"');
}

96
static int segment_mux_init(AVFormatContext *s)
97
{
98
    SegmentContext *seg = s->priv_data;
99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
    AVFormatContext *oc;
    int i;

    seg->avf = oc = avformat_alloc_context();
    if (!oc)
        return AVERROR(ENOMEM);

    oc->oformat            = seg->oformat;
    oc->interrupt_callback = s->interrupt_callback;

    for (i = 0; i < s->nb_streams; i++) {
        AVStream *st;
        if (!(st = avformat_new_stream(oc, NULL)))
            return AVERROR(ENOMEM);
        avcodec_copy_context(st->codec, s->streams[i]->codec);
        st->sample_aspect_ratio = s->streams[i]->sample_aspect_ratio;
    }

    return 0;
}

120
static int segment_start(AVFormatContext *s, int write_header)
121 122 123 124 125
{
    SegmentContext *c = s->priv_data;
    AVFormatContext *oc = c->avf;
    int err = 0;

126 127 128 129 130 131 132
    if (write_header) {
        avformat_free_context(oc);
        c->avf = NULL;
        if ((err = segment_mux_init(s)) < 0)
            return err;
        oc = c->avf;
    }
133

134 135
    if (c->segment_idx_wrap)
        c->segment_idx %= c->segment_idx_wrap;
136

137
    if (av_get_frame_filename(oc->filename, sizeof(oc->filename),
138
                              s->filename, c->segment_idx++) < 0) {
139
        av_log(oc, AV_LOG_ERROR, "Invalid segment filename template '%s'\n", s->filename);
140
        return AVERROR(EINVAL);
141
    }
142
    c->segment_count++;
143 144 145 146 147

    if ((err = avio_open2(&oc->pb, oc->filename, AVIO_FLAG_WRITE,
                          &s->interrupt_callback, NULL)) < 0)
        return err;

148
    if (oc->oformat->priv_class && oc->priv_data)
149
        av_opt_set(oc->priv_data, "resend_headers", "1", 0); /* mpegts specific */
150

151 152 153 154
    if (write_header) {
        if ((err = avformat_write_header(oc, NULL)) < 0)
            return err;
    }
155 156 157 158

    return 0;
}

159 160 161
static int segment_list_open(AVFormatContext *s)
{
    SegmentContext *seg = s->priv_data;
162 163 164 165 166 167 168
    int ret;

    ret = avio_open2(&seg->list_pb, seg->list, AVIO_FLAG_WRITE,
                     &s->interrupt_callback, NULL);
    if (ret < 0)
        return ret;
    seg->list_max_segment_time = 0;
169 170 171

    if (seg->list_type == LIST_TYPE_M3U8) {
        avio_printf(seg->list_pb, "#EXTM3U\n");
172
        avio_printf(seg->list_pb, "#EXT-X-VERSION:3\n");
173
        avio_printf(seg->list_pb, "#EXT-X-MEDIA-SEQUENCE:%d\n", seg->list_count);
174 175 176 177 178
        avio_printf(seg->list_pb, "#EXT-X-ALLOWCACHE:%d\n",
                    !!(seg->list_flags & SEGMENT_LIST_FLAG_CACHE));
        if (seg->list_flags & SEGMENT_LIST_FLAG_LIVE)
            avio_printf(seg->list_pb,
                        "#EXT-X-TARGETDURATION:%"PRId64"\n", seg->time / 1000000);
179 180
    }

181
    return ret;
182 183 184 185 186
}

static void segment_list_close(AVFormatContext *s)
{
    SegmentContext *seg = s->priv_data;
187 188

    if (seg->list_type == LIST_TYPE_M3U8) {
189 190 191
        if (!(seg->list_flags & SEGMENT_LIST_FLAG_LIVE))
            avio_printf(seg->list_pb, "#EXT-X-TARGETDURATION:%d\n",
                        (int)ceil(seg->list_max_segment_time));
192 193
        avio_printf(seg->list_pb, "#EXT-X-ENDLIST\n");
    }
194
    seg->list_count++;
195

196 197 198
    avio_close(seg->list_pb);
}

199
static int segment_end(AVFormatContext *s, int write_trailer)
200
{
201 202
    SegmentContext *seg = s->priv_data;
    AVFormatContext *oc = seg->avf;
203 204
    int ret = 0;

205
    av_write_frame(oc, NULL); /* Flush any buffered data (fragmented mp4) */
206
    if (write_trailer)
207
        ret = av_write_trailer(oc);
208

209
    if (ret < 0)
210
        av_log(s, AV_LOG_ERROR, "Failure occurred when ending segment '%s'\n",
211 212
               oc->filename);

213
    if (seg->list) {
214
        if (seg->list_size && !(seg->segment_count % seg->list_size)) {
215 216
            segment_list_close(s);
            if ((ret = segment_list_open(s)) < 0)
217 218
                goto end;
        }
219 220 221

        if (seg->list_type == LIST_TYPE_FLAT) {
            avio_printf(seg->list_pb, "%s\n", oc->filename);
222
        } else if (seg->list_type == LIST_TYPE_CSV || seg->list_type == LIST_TYPE_EXT) {
223 224
            print_csv_escaped_str(seg->list_pb, oc->filename);
            avio_printf(seg->list_pb, ",%f,%f\n", seg->start_time, seg->end_time);
225 226 227
        } else if (seg->list_type == LIST_TYPE_M3U8) {
            avio_printf(seg->list_pb, "#EXTINF:%f,\n%s\n",
                        seg->end_time - seg->start_time, oc->filename);
228
        }
229
        seg->list_max_segment_time = FFMAX(seg->end_time - seg->start_time, seg->list_max_segment_time);
230
        avio_flush(seg->list_pb);
231 232 233
    }

end:
234 235 236 237 238
    avio_close(oc->pb);

    return ret;
}

239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291
static int parse_times(void *log_ctx, int64_t **times, int *nb_times,
                       const char *times_str)
{
    char *p;
    int i, ret = 0;
    char *times_str1 = av_strdup(times_str);
    char *saveptr = NULL;

    if (!times_str1)
        return AVERROR(ENOMEM);

#define FAIL(err) ret = err; goto end

    *nb_times = 1;
    for (p = times_str1; *p; p++)
        if (*p == ',')
            (*nb_times)++;

    *times = av_malloc(sizeof(**times) * *nb_times);
    if (!*times) {
        av_log(log_ctx, AV_LOG_ERROR, "Could not allocate forced times array\n");
        FAIL(AVERROR(ENOMEM));
    }

    p = times_str1;
    for (i = 0; i < *nb_times; i++) {
        int64_t t;
        char *tstr = av_strtok(p, ",", &saveptr);
        av_assert0(tstr);
        p = NULL;

        ret = av_parse_time(&t, tstr, 1);
        if (ret < 0) {
            av_log(log_ctx, AV_LOG_ERROR,
                   "Invalid time duration specification in %s\n", p);
            FAIL(AVERROR(EINVAL));
        }
        (*times)[i] = t;

        /* check on monotonicity */
        if (i && (*times)[i-1] > (*times)[i]) {
            av_log(log_ctx, AV_LOG_ERROR,
                   "Specified time %f is greater than the following time %f\n",
                   (float)((*times)[i])/1000000, (float)((*times)[i-1])/1000000);
            FAIL(AVERROR(EINVAL));
        }
    }

end:
    av_free(times_str1);
    return ret;
}

292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311
static int open_null_ctx(AVIOContext **ctx)
{
    int buf_size = 32768;
    uint8_t *buf = av_malloc(buf_size);
    if (!buf)
        return AVERROR(ENOMEM);
    *ctx = avio_alloc_context(buf, buf_size, AVIO_FLAG_WRITE, NULL, NULL, NULL, NULL);
    if (!*ctx) {
        av_free(buf);
        return AVERROR(ENOMEM);
    }
    return 0;
}

static void close_null_ctx(AVIOContext *pb)
{
    av_free(pb->buffer);
    av_free(pb);
}

312 313 314
static int seg_write_header(AVFormatContext *s)
{
    SegmentContext *seg = s->priv_data;
315
    AVFormatContext *oc = NULL;
316 317
    int ret, i;

318
    seg->segment_count = 0;
319 320
    if (!seg->write_header_trailer)
        seg->individual_header_trailer = 0;
321

322
    if (seg->time_str && seg->times_str) {
323
        av_log(s, AV_LOG_ERROR,
324 325 326 327
               "segment_time and segment_times options are mutually exclusive, select just one of them\n");
        return AVERROR(EINVAL);
    }

328 329 330 331 332 333 334
    if ((seg->list_flags & SEGMENT_LIST_FLAG_LIVE) && seg->times_str) {
        av_log(s, AV_LOG_ERROR,
               "segment_flags +live and segment_times options are mutually exclusive:"
               "specify -segment_time if you want a live-friendly list\n");
        return AVERROR(EINVAL);
    }

335 336 337 338 339 340 341 342 343 344 345 346 347
    if (seg->times_str) {
        if ((ret = parse_times(s, &seg->times, &seg->nb_times, seg->times_str)) < 0)
            return ret;
    } else {
        /* set default value if not specified */
        if (!seg->time_str)
            seg->time_str = av_strdup("2");
        if ((ret = av_parse_time(&seg->time, seg->time_str, 1)) < 0) {
            av_log(s, AV_LOG_ERROR,
                   "Invalid time duration specification '%s' for segment_time option\n",
                   seg->time_str);
            return ret;
        }
348
    }
349

350 351 352 353 354 355 356 357 358
    if (seg->time_delta_str) {
        if ((ret = av_parse_time(&seg->time_delta, seg->time_delta_str, 1)) < 0) {
            av_log(s, AV_LOG_ERROR,
                   "Invalid time duration specification '%s' for delta option\n",
                   seg->time_delta_str);
            return ret;
        }
    }

359 360
    if (seg->list) {
        if (seg->list_type == LIST_TYPE_UNDEFINED) {
361 362
            if      (av_match_ext(seg->list, "csv" )) seg->list_type = LIST_TYPE_CSV;
            else if (av_match_ext(seg->list, "ext" )) seg->list_type = LIST_TYPE_EXT;
363 364 365
            else if (av_match_ext(seg->list, "m3u8")) seg->list_type = LIST_TYPE_M3U8;
            else                                      seg->list_type = LIST_TYPE_FLAT;
        }
366
        if ((ret = segment_list_open(s)) < 0)
367
            goto fail;
368
    }
369 370
    if (seg->list_type == LIST_TYPE_EXT)
        av_log(s, AV_LOG_WARNING, "'ext' list type option is deprecated in favor of 'csv'\n");
371

372
    for (i = 0; i < s->nb_streams; i++)
373 374 375 376 377 378 379 380
        seg->has_video +=
            (s->streams[i]->codec->codec_type == AVMEDIA_TYPE_VIDEO);

    if (seg->has_video > 1)
        av_log(s, AV_LOG_WARNING,
               "More than a single video stream present, "
               "expect issues decoding it.\n");

381
    seg->oformat = av_guess_format(seg->format, s->filename, NULL);
382

383
    if (!seg->oformat) {
384 385 386
        ret = AVERROR_MUXER_NOT_FOUND;
        goto fail;
    }
387
    if (seg->oformat->flags & AVFMT_NOFILE) {
388 389 390 391 392 393
        av_log(s, AV_LOG_ERROR, "format %s not supported.\n",
               oc->oformat->name);
        ret = AVERROR(EINVAL);
        goto fail;
    }

394 395 396
    if ((ret = segment_mux_init(s)) < 0)
        goto fail;
    oc = seg->avf;
397 398

    if (av_get_frame_filename(oc->filename, sizeof(oc->filename),
399
                              s->filename, seg->segment_idx++) < 0) {
400 401 402
        ret = AVERROR(EINVAL);
        goto fail;
    }
403
    seg->segment_count++;
404

405 406 407 408 409 410 411 412
    if (seg->write_header_trailer) {
        if ((ret = avio_open2(&oc->pb, oc->filename, AVIO_FLAG_WRITE,
                              &s->interrupt_callback, NULL)) < 0)
            goto fail;
    } else {
        if ((ret = open_null_ctx(&oc->pb)) < 0)
            goto fail;
    }
413 414 415 416 417 418

    if ((ret = avformat_write_header(oc, NULL)) < 0) {
        avio_close(oc->pb);
        goto fail;
    }

419 420 421
    if (oc->avoid_negative_ts > 0 && s->avoid_negative_ts < 0)
        s->avoid_negative_ts = 1;

422 423 424 425 426 427 428
    if (!seg->write_header_trailer) {
        close_null_ctx(oc->pb);
        if ((ret = avio_open2(&oc->pb, oc->filename, AVIO_FLAG_WRITE,
                              &s->interrupt_callback, NULL)) < 0)
            goto fail;
    }

429 430 431
fail:
    if (ret) {
        if (seg->list)
432
            segment_list_close(s);
433 434
        if (seg->avf)
            avformat_free_context(seg->avf);
435 436 437 438 439 440 441 442
    }
    return ret;
}

static int seg_write_packet(AVFormatContext *s, AVPacket *pkt)
{
    SegmentContext *seg = s->priv_data;
    AVFormatContext *oc = seg->avf;
443
    AVStream *st = s->streams[pkt->stream_index];
444
    int64_t end_pts;
445 446
    int ret;

447
    if (seg->times) {
448 449
        end_pts = seg->segment_count <= seg->nb_times ?
            seg->times[seg->segment_count-1] : INT64_MAX;
450
    } else {
451
        end_pts = seg->time * seg->segment_count;
452 453
    }

454 455
    /* if the segment has video, start a new segment *only* with a key video frame */
    if ((st->codec->codec_type == AVMEDIA_TYPE_VIDEO || !seg->has_video) &&
456
        av_compare_ts(pkt->pts, st->time_base,
457
                      end_pts-seg->time_delta, AV_TIME_BASE_Q) >= 0 &&
458 459
        pkt->flags & AV_PKT_FLAG_KEY) {

460 461
        av_log(s, AV_LOG_DEBUG, "Next segment starts with packet stream:%d pts:%"PRId64" pts_time:%f\n",
               pkt->stream_index, pkt->pts, pkt->pts * av_q2d(st->time_base));
462

463
        ret = segment_end(s, seg->individual_header_trailer);
464 465

        if (!ret)
466
            ret = segment_start(s, seg->individual_header_trailer);
467 468 469 470

        if (ret)
            goto fail;

471 472
        oc = seg->avf;

473 474 475 476
        seg->start_time = (double)pkt->pts * av_q2d(st->time_base);
    } else if (pkt->pts != AV_NOPTS_VALUE) {
        seg->end_time = FFMAX(seg->end_time,
                              (double)(pkt->pts + pkt->duration) * av_q2d(st->time_base));
477 478
    }

479
    ret = ff_write_chained(oc, pkt->stream_index, pkt, s);
480 481 482 483

fail:
    if (ret < 0) {
        if (seg->list)
484
            avio_close(seg->list_pb);
485 486 487 488 489 490 491 492 493 494
        avformat_free_context(oc);
    }

    return ret;
}

static int seg_write_trailer(struct AVFormatContext *s)
{
    SegmentContext *seg = s->priv_data;
    AVFormatContext *oc = seg->avf;
495 496
    int ret;
    if (!seg->write_header_trailer) {
497
        if ((ret = segment_end(s, 0)) < 0)
498
            goto fail;
499
        open_null_ctx(&oc->pb);
500
        ret = av_write_trailer(oc);
501 502
        close_null_ctx(oc->pb);
    } else {
503
        ret = segment_end(s, 1);
504
    }
505
fail:
506
    if (seg->list)
507
        segment_list_close(s);
508 509

    av_opt_free(seg);
510
    av_freep(&seg->times);
511

512 513 514 515 516 517 518
    avformat_free_context(oc);
    return ret;
}

#define OFFSET(x) offsetof(SegmentContext, x)
#define E AV_OPT_FLAG_ENCODING_PARAM
static const AVOption options[] = {
519 520
    { "segment_format",    "set container format used for the segments", OFFSET(format),  AV_OPT_TYPE_STRING, {.str = NULL},  0, 0,       E },
    { "segment_list",      "set the segment list filename",              OFFSET(list),    AV_OPT_TYPE_STRING, {.str = NULL},  0, 0,       E },
521 522 523 524 525

    { "segment_list_flags","set flags affecting segment list generation", OFFSET(list_flags), AV_OPT_TYPE_FLAGS, {.i64 = SEGMENT_LIST_FLAG_CACHE }, 0, UINT_MAX, E, "list_flags"},
    { "cache",             "allow list caching",                                    0, AV_OPT_TYPE_CONST, {.i64 = SEGMENT_LIST_FLAG_CACHE }, INT_MIN, INT_MAX,   E, "list_flags"},
    { "live",              "enable live-friendly list generation (useful for HLS)", 0, AV_OPT_TYPE_CONST, {.i64 = SEGMENT_LIST_FLAG_LIVE }, INT_MIN, INT_MAX,    E, "list_flags"},

526 527
    { "segment_list_size", "set the maximum number of playlist entries", OFFSET(list_size), AV_OPT_TYPE_INT,  {.i64 = 0},     0, INT_MAX, E },
    { "segment_list_type", "set the segment list type",                  OFFSET(list_type), AV_OPT_TYPE_INT,  {.i64 = LIST_TYPE_UNDEFINED}, -1, LIST_TYPE_NB-1, E, "list_type" },
528 529 530 531
    { "flat", "flat format",     0, AV_OPT_TYPE_CONST, {.i64=LIST_TYPE_FLAT }, INT_MIN, INT_MAX, 0, "list_type" },
    { "csv",  "csv format",      0, AV_OPT_TYPE_CONST, {.i64=LIST_TYPE_CSV  }, INT_MIN, INT_MAX, 0, "list_type" },
    { "ext",  "extended format", 0, AV_OPT_TYPE_CONST, {.i64=LIST_TYPE_EXT  }, INT_MIN, INT_MAX, 0, "list_type" },
    { "m3u8", "M3U8 format",     0, AV_OPT_TYPE_CONST, {.i64=LIST_TYPE_M3U8 }, INT_MIN, INT_MAX, 0, "list_type" },
532
    { "hls", "Apple HTTP Live Streaming compatible",     0, AV_OPT_TYPE_CONST, {.i64=LIST_TYPE_M3U8 }, INT_MIN, INT_MAX, 0, "list_type" },
533
    { "segment_time",      "set segment duration",                       OFFSET(time_str),AV_OPT_TYPE_STRING, {.str = NULL},  0, 0,       E },
534
    { "segment_time_delta","set approximation value used for the segment times", OFFSET(time_delta_str), AV_OPT_TYPE_STRING, {.str = "0"}, 0, 0, E },
535
    { "segment_times",     "set segment split time points",              OFFSET(times_str),AV_OPT_TYPE_STRING,{.str = NULL},  0, 0,       E },
536
    { "segment_wrap",      "set number after which the index wraps",     OFFSET(segment_idx_wrap), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, E },
537
    { "individual_header_trailer", "write header/trailer to each segment", OFFSET(individual_header_trailer), AV_OPT_TYPE_INT, {.i64 = 1}, 0, 1, E },
538
    { "write_header_trailer", "write a header to the first segment and a trailer to the last one", OFFSET(write_header_trailer), AV_OPT_TYPE_INT, {.i64 = 1}, 0, 1, E },
539 540 541 542 543 544 545 546 547 548 549 550
    { NULL },
};

static const AVClass seg_class = {
    .class_name = "segment muxer",
    .item_name  = av_default_item_name,
    .option     = options,
    .version    = LIBAVUTIL_VERSION_INT,
};

AVOutputFormat ff_segment_muxer = {
    .name           = "segment",
551
    .long_name      = NULL_IF_CONFIG_SMALL("segment"),
552
    .priv_data_size = sizeof(SegmentContext),
553
    .flags          = AVFMT_NOFILE,
554 555 556 557 558
    .write_header   = seg_write_header,
    .write_packet   = seg_write_packet,
    .write_trailer  = seg_write_trailer,
    .priv_class     = &seg_class,
};
559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576

static const AVClass sseg_class = {
    .class_name = "stream_segment muxer",
    .item_name  = av_default_item_name,
    .option     = options,
    .version    = LIBAVUTIL_VERSION_INT,
};

AVOutputFormat ff_stream_segment_muxer = {
    .name           = "stream_segment,ssegment",
    .long_name      = NULL_IF_CONFIG_SMALL("streaming segment muxer"),
    .priv_data_size = sizeof(SegmentContext),
    .flags          = AVFMT_NOFILE,
    .write_header   = seg_write_header,
    .write_packet   = seg_write_packet,
    .write_trailer  = seg_write_trailer,
    .priv_class     = &sseg_class,
};