From patchwork Fri Jul 14 07:49:44 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Zimmermann X-Patchwork-Id: 120303 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:a6b2:0:b0:3e4:2afc:c1 with SMTP id c18csp2341387vqm; Fri, 14 Jul 2023 00:55:40 -0700 (PDT) X-Google-Smtp-Source: APBJJlEaMGX/IygKyRqh6uU3e9Nso304qREwW+SnnJI9OHiNgIaj//6a8wOpstsEFTTAUIMmDp/Y X-Received: by 2002:a05:6402:499:b0:51e:1c5c:b97f with SMTP id k25-20020a056402049900b0051e1c5cb97fmr2759205edv.2.1689321340577; Fri, 14 Jul 2023 00:55:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1689321340; cv=none; d=google.com; s=arc-20160816; b=W0sjpcVMeMxGgsqeYgk0x92HKcvYIu3ndOAdGN8DwWZTIAr4h+kS0mlJBlVwQWwIgI D9ZTwg3zCyASkIY2Na8ltKrZ/gMdyhbTUdkUBBCsTR4otzr+HYlgCL88z9wH14L8Dmgn Tg3ktZM5QI0D8GcrRP90O0vFg6cHoeL2MpBsuCJ6/I9aIPGRCMcKSG08DFelWKJp7kum EVQN5wh9wD1/BHBNTglTfTR6fy6EJuVseospZJablHwDYpm2vnx8SXk4rdFvp+e8PUmJ ofpiBE0hG+YDVX5Sf3HPh5hi902qgw/4QGWhrcth5AVoLwixnciDftyAd3v4+lizmWIN GYhA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature:dkim-signature; bh=fjE7evrec+6fTNNO2iEP5O884klzqzhDg9Mgv82xETg=; fh=YJs0q611+99g9v9CtNUMd8VTZTbqZYHlrAcs4ODryW8=; b=Wf4OovVH+eNkqER9PZqQkwQ9hKhzDczt+Kh7QZOMILYF0RHeosaYPOeaGjmXS/y6aB xMNZrnAK3eABwUlfbKXHg5AGleEXhN3bkNo+FgV+vEfIy8dgoEz70NFvWwa2xIVgbeqB OLNCyhiZgeH5fj7MNV3FjEkKNDZPMRWoam2F9/OQFX+sh05wPV/uuebgdAqBf9yfGvSc ggAI3g/qJV76sAilt2sN87MvwMjdNfQBjGHKGZFploEKEav0NH+lGyZm6Sgr0XinvXmc lDcyJOiQ63fwTFC7jZaz2FaQM99ZF6/JijxmhzdjgjS+fsQU6D1BmVVmlyjMBLvaOO6a EF/g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@suse.de header.s=susede2_rsa header.b=Lh7vIr6c; dkim=neutral (no key) header.i=@suse.de header.s=susede2_ed25519 header.b=QGMxHCNv; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=suse.de Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id x17-20020aa7cd91000000b0051def0da189si8255033edv.547.2023.07.14.00.55.15; Fri, 14 Jul 2023 00:55:40 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@suse.de header.s=susede2_rsa header.b=Lh7vIr6c; dkim=neutral (no key) header.i=@suse.de header.s=susede2_ed25519 header.b=QGMxHCNv; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=suse.de Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235829AbjGNHxH (ORCPT + 99 others); Fri, 14 Jul 2023 03:53:07 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45946 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235568AbjGNHwI (ORCPT ); Fri, 14 Jul 2023 03:52:08 -0400 Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D58523588; Fri, 14 Jul 2023 00:52:05 -0700 (PDT) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id 83D7622163; Fri, 14 Jul 2023 07:52:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_rsa; t=1689321124; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=fjE7evrec+6fTNNO2iEP5O884klzqzhDg9Mgv82xETg=; b=Lh7vIr6ckxc/iABjsJgQyPX2+F649Ga1fLcw+t6ynF0XPltSHJcY7keOXADImMc/dbsXKp xyUOTHFD9ZSU9WbwlNosGPDYqOHjdKPKebwbu8snAFn0N1/u3gpsb9A2fV2S9P5gnWwuAA c11Id3xw4wVOPXXYVUeNCX9YszdHQ3s= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_ed25519; t=1689321124; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=fjE7evrec+6fTNNO2iEP5O884klzqzhDg9Mgv82xETg=; b=QGMxHCNv2iIjqPsDqSpcZCEXodf5ZsEvU0z7mPx0TmyWW116Sni3xmSwhsAgfcnLkU6nOS SUzZMqMdOAUlo3Bw== Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id 2D2A413A15; Fri, 14 Jul 2023 07:52:04 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id sM0TCqT+sGQCQwAAMHmgww (envelope-from ); Fri, 14 Jul 2023 07:52:04 +0000 From: Thomas Zimmermann To: deller@gmx.de, javierm@redhat.com Cc: linux-sh@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, amd-gfx@lists.freedesktop.org, linux-input@vger.kernel.org, linux-media@vger.kernel.org, linux-fbdev@vger.kernel.org, linux-staging@lists.linux.dev, linux-arm-kernel@lists.infradead.org, linux-geode@lists.infradead.org, linux-nvidia@lists.surfsouth.com, linux-hyperv@vger.kernel.org, linux-omap@vger.kernel.org, linuxppc-dev@lists.ozlabs.org, kvm@vger.kernel.org, Thomas Zimmermann , Miguel Ojeda Subject: [PATCH v3 18/18] fbdev: Document that framebuffer_alloc() returns zero'ed data Date: Fri, 14 Jul 2023 09:49:44 +0200 Message-ID: <20230714075155.5686-19-tzimmermann@suse.de> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230714075155.5686-1-tzimmermann@suse.de> References: <20230714075155.5686-1-tzimmermann@suse.de> MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_PASS,T_SCC_BODY_TEXT_LINE,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1771381813940417426 X-GMAIL-MSGID: 1771381813940417426 Most fbdev drivers depend on framebuffer_alloc() to initialize the allocated memory to 0. Document this guarantee. v3: * slightly reword the sentence (Miguel) Suggested-by: Miguel Ojeda Signed-off-by: Thomas Zimmermann Reviewed-by: Miguel Ojeda Cc: Helge Deller Reviewed-by: Sui Jingfeng --- drivers/video/fbdev/core/fb_info.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/drivers/video/fbdev/core/fb_info.c b/drivers/video/fbdev/core/fb_info.c index 8bdbefdd4b70..4847ebe50d7d 100644 --- a/drivers/video/fbdev/core/fb_info.c +++ b/drivers/video/fbdev/core/fb_info.c @@ -13,7 +13,8 @@ * * Creates a new frame buffer info structure. Also reserves @size bytes * for driver private data (info->par). info->par (if any) will be - * aligned to sizeof(long). + * aligned to sizeof(long). The new instances of struct fb_info and + * the driver private data are both cleared to zero. * * Returns the new structure, or NULL if an error occurred. *