From patchwork Sun Sep 25 00:11:14 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marvin Scholz X-Patchwork-Id: 38257 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:3b1c:b0:96:9ee8:5cfd with SMTP id c28csp1392378pzh; Sat, 24 Sep 2022 17:18:35 -0700 (PDT) X-Google-Smtp-Source: AMsMyM74TUKHtpm9HRKYe0/6MJ2mkBdeQNIzNC3JhuPQSXznVZ5YqTVhYR5A+NgVyahBIYsXueo8 X-Received: by 2002:a17:907:783:b0:76e:f290:8b5 with SMTP id xd3-20020a170907078300b0076ef29008b5mr13099673ejb.395.1664065114728; Sat, 24 Sep 2022 17:18:34 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1664065114; cv=none; d=google.com; s=arc-20160816; b=SsHvACOg1opLeGPxSy8ONaZzocUNMo7syCbbyVQllBAO4oRxOsKMF5lP3HG5YoFL5e I2lxS7vRJfV1TpUTjX7C07FZtuzlzmch5MnGJwMfdrXCrppBgdC+zY4c8Snsa0Oz6We0 AzRybVyz2U/Q+jEKwB88Cz/n63BZsz95AMq8yONXLh399YFkEaZbrMJdxtt81D8IvPPb BMMqW9qH0iDBjQ9deAOO5RztEf241JnyadX2pAOr9UJXSKj0ElOALFmNfvekx3iU0TYc jxCZS2fJoEutXENwixlAKPfOklczr+U70S1460Xdt7Ctouk4G+6IR1axJLbPZGxFnaEf WgDg== 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=LrSantEiDNN6Fks+Q01a1F+UoXdoXE6JovsEHl/QDUE=; b=k30mi7XaiXd2mdEGoII6r4b8/ACwBA8jFeOHqI3ouG2/7V56HadLNMBUoQqyBJpKUY SKEnuXPVVuBc/iZ0XDbb+ZWkvElzV8g/9Fj7spfWENmWMLvsDgafLCYJw5XfiH9pC1G0 0TuTFn71vntqiro07zj65W+daGWfwB48IcuEUfdGWHOy0x9DAyckCkoi5bmXiUWhWp0R eKI/7M7sH7v3cri8t9O/Fxk0q1aSBAjsrysBjyoc+Y8Sr1OIR64vWiRL0eLZi8HfqtLs +wKOOtTA8a/ZQu23Ut8mU39A0KmqNpoYvNmAnpLJRcCcVAuYt/MmCx9ZVDppFeovW+iF p0/Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b=nIuvFltZ; 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 hd17-20020a170907969100b0076f65528ab0si13549148ejc.733.2022.09.24.17.18.34; Sat, 24 Sep 2022 17:18:34 -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=nIuvFltZ; 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 CDFA668BC87; Sun, 25 Sep 2022 03:12:39 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-ej1-f49.google.com (mail-ej1-f49.google.com [209.85.218.49]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id B152368BC81 for ; Sun, 25 Sep 2022 03:12:36 +0300 (EEST) Received: by mail-ej1-f49.google.com with SMTP id 13so7460406ejn.3 for ; Sat, 24 Sep 2022 17:12:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date; bh=UusPTNwipAxrpKp8FRCk/eJWR7xD/AGn1LfBcGqYz+M=; b=nIuvFltZPl3onjoQt4PC1NVMJyPsgUs21L6fpLoh8tNs9IS6YB7YJlDRYjzkJuw8wO X1MQR7t9B4/33rK6CgmDfxg6mYiblILXsIFqzdKZeLPVaqVTpv2r8myJS/+LxK3F7vk9 hFzOJWEKCYkqseytlheoYHUeV+jD96vymRA/5HkAaU1iWFwsVOxPLwpGl8VsvzYfYKzY JakjHkV+EnivEznxPXGe8x+YhCvuIq0XkphxgODnpChvWP2QoVzYhBxtn6nhoVRL6XGs I21V4ELPcBxjPROQmWeiSPnLDV+Y6xIruUZNQlbvKHN+vKJLUHvV+pb3Gp5LEoaqOwJ7 QgCw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date; bh=UusPTNwipAxrpKp8FRCk/eJWR7xD/AGn1LfBcGqYz+M=; b=ckkGz0HDkbFdAzIj8MOFCs+0P4W8iWwdqgjsIt8fgZnP2gj+6ini++ppXN9uD5pzfm H+G6hT9Lvy51kwwREiCptGg1f83+AnqKiyDAhlfmDnmIIPDZiJO+Mo3w8b/gxELzNtM6 wQLwrWt2GJvnNRWNFsS/v5hxePIqVtzmPK9bjgDZOCN9tk3k5eIi0Och+lCWSG1BvumR dIUSkIFDWTEP1OEVoATRNL6I50Nq0dV5jrCKNV9E7ZAl3rfCY9jHwjoWg0Ge72PyIjnT w4K0jnSN8tKnm7fGJGxrBEuFJx4tb82Js2FV8JPNTx6bjJ6Qq0O/MWA1s6z2pQqsVduc e3dA== X-Gm-Message-State: ACrzQf0f2u4CY3Wji9V9JxdZSeSuEo95PW9WwrPFmqIOiTQyDQVqpoaR YwwFO4nQronFT+328BVdG0LlTLSPdA0= X-Received: by 2002:a17:907:7b95:b0:72f:9c64:4061 with SMTP id ne21-20020a1709077b9500b0072f9c644061mr12914103ejc.351.1664064756075; Sat, 24 Sep 2022 17:12:36 -0700 (PDT) Received: from MBP-von-Marvin.citadel.scalie.me (84-112-104-25.cable.dynamic.surfer.at. [84.112.104.25]) by smtp.gmail.com with ESMTPSA id kz3-20020a17090777c300b007812ba2a360sm6208042ejc.149.2022.09.24.17.12.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 24 Sep 2022 17:12:35 -0700 (PDT) From: Marvin Scholz To: ffmpeg-devel@ffmpeg.org Date: Sun, 25 Sep 2022 02:11:14 +0200 Message-Id: <20220925001121.37721-48-epirat07@gmail.com> X-Mailer: git-send-email 2.37.0 (Apple Git-136) In-Reply-To: <20220925001121.37721-1-epirat07@gmail.com> References: <20220922020400.46715-1-epirat07@gmail.com> <20220925001121.37721-1-epirat07@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v3 47/54] avutil/des: Add doxy for missing arguments 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: Marvin Scholz Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: mp30uZPGq2Fo Additionally reorder so that the arguments list matches the order of the arguments in the function declaration. --- libavutil/des.h | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/libavutil/des.h b/libavutil/des.h index 4cf11f5bca..3a3e6fa47c 100644 --- a/libavutil/des.h +++ b/libavutil/des.h @@ -43,6 +43,8 @@ AVDES *av_des_alloc(void); /** * @brief Initializes an AVDES context. * + * @param d pointer to a AVDES structure to initialize + * @param key pointer to the key to use * @param key_bits must be 64 or 192 * @param decrypt 0 for encryption/CBC-MAC, 1 for decryption * @return zero on success, negative value otherwise @@ -52,9 +54,10 @@ int av_des_init(struct AVDES *d, const uint8_t *key, int key_bits, int decrypt); /** * @brief Encrypts / decrypts using the DES algorithm. * - * @param count number of 8 byte blocks + * @param d pointer to the AVDES structure * @param dst destination array, can be equal to src, must be 8-byte aligned * @param src source array, can be equal to dst, must be 8-byte aligned, may be NULL + * @param count number of 8 byte blocks * @param iv initialization vector for CBC mode, if NULL then ECB will be used, * must be 8-byte aligned * @param decrypt 0 for encryption, 1 for decryption @@ -64,9 +67,10 @@ void av_des_crypt(struct AVDES *d, uint8_t *dst, const uint8_t *src, int count, /** * @brief Calculates CBC-MAC using the DES algorithm. * - * @param count number of 8 byte blocks + * @param d pointer to the AVDES structure * @param dst destination array, can be equal to src, must be 8-byte aligned * @param src source array, can be equal to dst, must be 8-byte aligned, may be NULL + * @param count number of 8 byte blocks */ void av_des_mac(struct AVDES *d, uint8_t *dst, const uint8_t *src, int count);