From patchwork Wed Mar 30 12:17:46 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Diederick C. Niehorster" X-Patchwork-Id: 35055 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:c05:b0:7a:e998:b410 with SMTP id bw5csp773671pzb; Wed, 30 Mar 2022 05:18:41 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxXbin8zEEluVaVSXtcGzPzXCLOIHRvwpYrzHtxiqnbFCElCX8q3e6D5meq5y9T9AsSsZp7 X-Received: by 2002:a05:6402:60e:b0:419:d2e:bcea with SMTP id n14-20020a056402060e00b004190d2ebceamr10364891edv.326.1648642721122; Wed, 30 Mar 2022 05:18:41 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1648642721; cv=none; d=google.com; s=arc-20160816; b=tZAKxbLV1c1kKtk8GVQCODDj019luUpn53r3p58ot0hl508WwPpXl+q63cAsDaoUDK VUEm/Uvmx20znks2E9qJOHYaq+GtJggmdeZlLWp5YeL61fKDTnHxOemz0k0IA7lOfMEa 4+M9clbZCjFxW2G1XCpHWHscdrhcNyscB2HTyN2Yeym/Ze3sNlEQ1urAT0I8NhbMjL5/ nfWxg7DqnSv/iMRxpXQvjZoUE6tgDjOQDb0mZC0FKYzYfg5DKr+1CTJt5uZC8JTDLeKI jXrhWtc5hwjk/9gxLD/BSqlY8QR+PuG4+m1pOzk7svR7tvQAkGg4AU8JjGcEToNIE7Gn nSnw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:cc:reply-to :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:mime-version:references:in-reply-to :message-id:date:to:from:dkim-signature:delivered-to; bh=ziWDb/uH8Ug+a/ifWoMZpl8hLxB1eBWnYcnziMElX/E=; b=RfZZEs9wee0iNIgjJRCJRCs7zwi0xaW1nhV/7ipZUO6KlUC2rYFzQdwycsiELkrb64 MEHnUOsL4xG7gBFuzIEgpepwHbwyc6lonA352FRppRflgW/wdP7nJPgXxjt+JDW8Q+mZ lSsgQF2GyDigEE77LC7hoOkruPxgCbVzLvUp3rg4Iyr73rvNJpAdF6W320XivJ9WRVAO +kVi7NM4sihUB+O3hdUQQuk3dJ4QOdy50faKBdcXji8Y1BP5zkIGrpSBsTrGF4YjS+cv leJzv5OWyeRcWa6T13AjGJU2SlHCkCx1t4Ru32bBJ2kJpwAamscHNzoxYIhYPbuHm4YC H4sg== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b="ZyMx8pj/"; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id ot5-20020a170906ccc500b006e002ecc82esi20508734ejb.45.2022.03.30.05.18.40; Wed, 30 Mar 2022 05:18:41 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b="ZyMx8pj/"; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 1720568B1DF; Wed, 30 Mar 2022 15:18:34 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-lj1-f172.google.com (mail-lj1-f172.google.com [209.85.208.172]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id BA1E268B122 for ; Wed, 30 Mar 2022 15:18:27 +0300 (EEST) Received: by mail-lj1-f172.google.com with SMTP id r22so27418451ljd.4 for ; Wed, 30 Mar 2022 05:18:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=hP21fZm8JfZWDp5nhsf5pz5q6K9mehCDVrmzhfKoHXQ=; b=ZyMx8pj/QBisS9glGOT/lFPf00gTeVnC5SNX2l0PFKrlJ14+mkCWQz+elzuhiZwKd6 Gs3NapuIT5mRWvxoQSed6zQROqPmGbHpXnKcSJbjmWo6ZWnfJcZD160wlhFOqYkxwENb Zpfg44z6xZJjIg8psUjzVVMTNaAorCEFuQjqrD4cV5UoSBth2VVHT5NKItv7AzrGOZvn VrLb92Ul7i1hgDfhWCwzcYOsesx8RMlMq63ct5s/1wQaq0lNaRkszbsrahpi8h4iyoI3 43Gc+5FAhDlyYhIduCh+abQQWZT8hxV9eon/eUrw7akLE3eyVaV6iz6JiquqFcliCv4E fhNA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=hP21fZm8JfZWDp5nhsf5pz5q6K9mehCDVrmzhfKoHXQ=; b=aY/gkvl7J/p1kaCGfBQHGsjScMHLymHUem2d0b4Ile7j7rz2lOXML6DC88xhEZlOlr cm7OZag8b8cGooZu9fWeM4gNBozIxe+qrmVQoe+0I5kUnDorekBrG+zlgAp7GeVB0dhT qSOsWG+9QY4tJdLkT3uhran0uR740KK85iaOijzUAe/g1J3kVJRltaZREhgj34zAiE1r +grfj7f230p00RHKWQYGz8wWF854KX3lhk3wd3Jl/JQN5YLkflVF+4m2PeSm1NN03jXk oj4sE3cikMyhq56d3i07R0MkGgpDnx2CJpwx//P+/vbcbNl8yfeEvDEMmNHK5fzgjoBb Bw2Q== X-Gm-Message-State: AOAM5336HtmGyT5N4UDbQLgUlIYcjQsLZyLbw47Ok+Cd6bfYRgvn9TpZ I7X0hIojzaGAyKELdah33tZJO3ZWzC4= X-Received: by 2002:a2e:97c9:0:b0:249:8404:a5b7 with SMTP id m9-20020a2e97c9000000b002498404a5b7mr6421143ljj.57.1648642706772; Wed, 30 Mar 2022 05:18:26 -0700 (PDT) Received: from localhost.localdomain (deedock.humlab.lu.se. [130.235.135.183]) by smtp.gmail.com with ESMTPSA id bj15-20020a2eaa8f000000b00246233c02a5sm2364563ljb.44.2022.03.30.05.18.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 30 Mar 2022 05:18:25 -0700 (PDT) From: Diederick Niehorster To: ffmpeg-devel@ffmpeg.org Date: Wed, 30 Mar 2022 14:17:46 +0200 Message-Id: <20220330121806.822-2-dcnieho@gmail.com> X-Mailer: git-send-email 2.28.0.windows.1 In-Reply-To: <20220330121806.822-1-dcnieho@gmail.com> References: <20220330121806.822-1-dcnieho@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v5 01/21] avdevice: lock to minor version of avformat X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: Diederick Niehorster Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: B2KjeZxpzC5R As per discussion on the list ( https://ffmpeg.org/pipermail/ffmpeg-devel/2021-June/281513.html, see especially https://ffmpeg.org/pipermail/ffmpeg-devel/2021-June/281586.html), to resolve the the unholy ABI-relationship between libavdevice and libavformat and allow easier working on the part of the avdevice API that lives in avformat, lock avdevice to a specific major and minor version of avformat. Documentation of this restriction added. Signed-off-by: Diederick Niehorster --- libavdevice/avdevice.c | 13 +++++++++++++ libavdevice/avdevice.h | 10 ++++++++++ libavdevice/version.h | 13 ++++++++++++- libavformat/avformat.h | 3 +++ libavformat/utils.c | 5 +++++ libavformat/version.h | 14 ++++++++++++-- libavutil/avutil.h | 3 +++ libavutil/macros.h | 3 +++ 8 files changed, 61 insertions(+), 3 deletions(-) diff --git a/libavdevice/avdevice.c b/libavdevice/avdevice.c index 833d200054..98934abfb7 100644 --- a/libavdevice/avdevice.c +++ b/libavdevice/avdevice.c @@ -19,6 +19,7 @@ #include "libavutil/avassert.h" #include "libavutil/samplefmt.h" #include "libavutil/pixfmt.h" +#include "libavformat/version.h" #include "avdevice.h" #include "internal.h" #include "config.h" @@ -39,6 +40,18 @@ unsigned avdevice_version(void) return LIBAVDEVICE_VERSION_INT; } +unsigned avdevice_version_same_minor(void) +{ + // check version of loaded lavf has same major and minor version as + // this library was compiled against + // NB: this function doesn't have to be called, dynamic linker will + // signal error when avformat of wrong major or minor version is found. + if ((avformat_version_same_minor()) & ~0xFF != (LIBAVFORMAT_VERSION_INT & ~0xFF)) + abort(); + + return avdevice_version(); +} + const char * avdevice_configuration(void) { return FFMPEG_CONFIGURATION; diff --git a/libavdevice/avdevice.h b/libavdevice/avdevice.h index 0b32e59fed..db16a2f27e 100644 --- a/libavdevice/avdevice.h +++ b/libavdevice/avdevice.h @@ -47,6 +47,16 @@ * * To use libavdevice, simply call avdevice_register_all() to register all * compiled muxers and demuxers. They all use standard libavformat API. + * + * Note that libavdevice is locked to be used with the same major and minor + * version of libavformat that it was built against. Attempting to use a + * shared build of FFmpeg or its libavdevice library with a libavformat of + * a different major or minor version will generate a dynamic linker error. + * This is achieved by the internal function check_avformat_same_minor() in + * avdevice.c. This function does not have to be called, its call to + * avformat_version_same_minor() (a macro which expands to a name with the + * specific major and minor version of avformat embedded in it) is sufficient + * to trigger link failure. * * @{ */ diff --git a/libavdevice/version.h b/libavdevice/version.h index 09c1d778dc..4efe7f8649 100644 --- a/libavdevice/version.h +++ b/libavdevice/version.h @@ -26,10 +26,11 @@ */ #include "libavutil/version.h" +#include "libavutil/macros.h" #include "version_major.h" -#define LIBAVDEVICE_VERSION_MINOR 6 +#define LIBAVDEVICE_VERSION_MINOR 7 #define LIBAVDEVICE_VERSION_MICRO 100 #define LIBAVDEVICE_VERSION_INT AV_VERSION_INT(LIBAVDEVICE_VERSION_MAJOR, \ @@ -42,4 +43,14 @@ #define LIBAVDEVICE_IDENT "Lavd" AV_STRINGIFY(LIBAVDEVICE_VERSION) +/** + * avdevice_version_same_minor() expands to a function with + * the same minor and major version it was compiled against + * encoded in it. Enables locking to the minor version of + * other libraries they were compiled against. Does not have + * to be called by user. + */ +#define avdevice_version_same_minor AV_MAKE_MAJOR_MINOR_FUNC_NAME(device,LIBAVFORMAT_VERSION_MAJOR,LIBAVFORMAT_VERSION_MINOR) +unsigned avdevice_version_same_minor(void); + #endif /* AVDEVICE_VERSION_H */ diff --git a/libavformat/avformat.h b/libavformat/avformat.h index f12fa7d904..350912e272 100644 --- a/libavformat/avformat.h +++ b/libavformat/avformat.h @@ -64,6 +64,9 @@ * set by user for input, always set by user for output (unless you are dealing * with an AVFMT_NOFILE format). * + * Note that libavdevice is locked to a specific major and minor version of + * libavformat, see @ref lavd "libavdevice" for more details. + * * @section lavf_options Passing options to (de)muxers * It is possible to configure lavf muxers and demuxers using the @ref avoptions * mechanism. Generic (format-independent) libavformat options are provided by diff --git a/libavformat/utils.c b/libavformat/utils.c index 3f253c2045..6d9c4e778a 100644 --- a/libavformat/utils.c +++ b/libavformat/utils.c @@ -64,6 +64,11 @@ unsigned avformat_version(void) return LIBAVFORMAT_VERSION_INT; } +unsigned avformat_version_same_minor(void) +{ + return avformat_version(); +} + const char *avformat_configuration(void) { return FFMPEG_CONFIGURATION; diff --git a/libavformat/version.h b/libavformat/version.h index f4a26c2870..bb6a7d4510 100644 --- a/libavformat/version.h +++ b/libavformat/version.h @@ -28,11 +28,12 @@ */ #include "libavutil/version.h" +#include "libavutil/macros.h" #include "version_major.h" -#define LIBAVFORMAT_VERSION_MINOR 20 -#define LIBAVFORMAT_VERSION_MICRO 101 +#define LIBAVFORMAT_VERSION_MINOR 21 +#define LIBAVFORMAT_VERSION_MICRO 100 #define LIBAVFORMAT_VERSION_INT AV_VERSION_INT(LIBAVFORMAT_VERSION_MAJOR, \ LIBAVFORMAT_VERSION_MINOR, \ @@ -44,4 +45,13 @@ #define LIBAVFORMAT_IDENT "Lavf" AV_STRINGIFY(LIBAVFORMAT_VERSION) +/** + * avformat_version_same_minor() expands to a function with + * the same minor and major version it was compiled against + * encoded in it. Enables locking to the minor version of + * other libraries they were compiled against. + */ +#define avformat_version_same_minor AV_MAKE_MAJOR_MINOR_FUNC_NAME(format,LIBAVFORMAT_VERSION_MAJOR,LIBAVFORMAT_VERSION_MINOR) +unsigned avformat_version_same_minor(void); + #endif /* AVFORMAT_VERSION_H */ diff --git a/libavutil/avutil.h b/libavutil/avutil.h index 4d633156d1..94ce472c27 100644 --- a/libavutil/avutil.h +++ b/libavutil/avutil.h @@ -76,6 +76,9 @@ * situations may change slightly (and be documented). All those are accompanied * by an entry in doc/APIchanges and incrementing either the minor or micro * version number. + * + * Note that libavdevice is locked to a specific major and minor version of + * libavformat, see @ref lavd "libavdevice" for more details. */ /** diff --git a/libavutil/macros.h b/libavutil/macros.h index 2a7567c3ea..dab530a8a0 100644 --- a/libavutil/macros.h +++ b/libavutil/macros.h @@ -73,6 +73,9 @@ * @} */ +#define AV_MAKE_MAJOR_MINOR_FUNC_NAME_IMPL(name,major,minor) av ## name ## _version_ ## major ## _ ## minor +#define AV_MAKE_MAJOR_MINOR_FUNC_NAME(name,major,minor) AV_MAKE_MAJOR_MINOR_FUNC_NAME_IMPL(name,major,minor) + #define AV_PRAGMA(s) _Pragma(#s) #define FFALIGN(x, a) (((x)+(a)-1)&~((a)-1))