From patchwork Sat Jul 15 18:52:00 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Zimmermann X-Patchwork-Id: 120839 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:c923:0:b0:3e4:2afc:c1 with SMTP id j3csp298179vqt; Sat, 15 Jul 2023 11:57:21 -0700 (PDT) X-Google-Smtp-Source: APBJJlHLKSEr6ccOws4OlwpXPxtqvMiwJat3TktYNOtbiC0pQkND9/ygUsQY0UTEc2Zbr6+Sk74s X-Received: by 2002:aa7:dd09:0:b0:521:7181:e8b7 with SMTP id i9-20020aa7dd09000000b005217181e8b7mr2065011edv.40.1689447440943; Sat, 15 Jul 2023 11:57:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1689447440; cv=none; d=google.com; s=arc-20160816; b=imHO6IWiY+FxCr+c73l/AwuMyGBAHmzw7525jfG1s3zU1V8h/IKgjjQTnpyiujdsA8 TZ/570YfpWcWJdGnfRysYBi9+TeQYQK2BW4ZG4AOHV83hZdzwBlYFLUMtgy+XEGmgZvY 3DEtkg8n/DV6LAZfCN/lygoho+sxnr5G1mPUC/e1fyqYxudh+GQIGW6Jpfd6baq44KPS Q1ttLbnMJBi5jQ+2ELS5iePXUNw7BlGGfSu6OGS3x1YM6+bPk1JBkrw1v3VjEalIOM3R blA0TL6bQsTgqNAaPzlEkiBTyoESmSAPsmAjM15BPmcpNt39iSChcNWIaC9wdBt0f19+ dxVQ== 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=rN7iXgHdNfoVTGsKEMlM6qhA1C0OhaHzC+3XBqWokqM=; fh=ZVOEKwUC2FQ72rTocEIhd9kx+ABcHeG/tLshN/oFg58=; b=xn+N7zhdXvoqcw3R8RAYl5scgfhmk9MmkayhWs42bJntJzZBqcmZogI9xX34sl6D7t H9/dcLxX88RkyiKfhX0ngJ7vOBYdWjczOOnkgbREBcTLNn1UO3iBgjcG7g/fiqdFaL0f s2/OrWTVIIFUW3vzKsUlOrgZGGQbbGyj0Cew8k0v5a8FqBhFt7q2ribFKs3fGIC1GpwQ Ti5oLoc4d3D/HLPAVN8eeiXk61cj1IA0ebXhoTRz0EywGqKOmcHuJqYctljSXLYPMHZg RmE76Da/PNlKF6rdvapZ5k8Khbv2mRUhsrEIbYuezO6GBuOM7HD+JEzkXfl0mlJo6l/s c6Pg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@suse.de header.s=susede2_rsa header.b=0CLO+Jl4; dkim=neutral (no key) header.i=@suse.de header.s=susede2_ed25519 header.b=+mXK0HAm; 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 v11-20020aa7d9cb000000b0051a595dc64bsi10764600eds.105.2023.07.15.11.56.57; Sat, 15 Jul 2023 11:57:20 -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=0CLO+Jl4; dkim=neutral (no key) header.i=@suse.de header.s=susede2_ed25519 header.b=+mXK0HAm; 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 S231432AbjGOSzE (ORCPT + 99 others); Sat, 15 Jul 2023 14:55:04 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50156 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230474AbjGOSyC (ORCPT ); Sat, 15 Jul 2023 14:54:02 -0400 Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2705A30FD; Sat, 15 Jul 2023 11:53:59 -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 D31A621B48; Sat, 15 Jul 2023 18:53:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_rsa; t=1689447233; 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=rN7iXgHdNfoVTGsKEMlM6qhA1C0OhaHzC+3XBqWokqM=; b=0CLO+Jl4RJxV02TQgGz1lVL0Z9mSQ1j0P+DgJ0nbU3UREBFXn2S5HeoaA8EFIUrK8+tzuG kTXqLC5ehTyt80dsVHiDLOBo2qQe1dSoc8WH+TmzBpFIYDvstFzOhzYqpjWqEoNBLAnMl7 R7fqYYnu/SFLBf1BHOVJWcubFCaLJXE= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_ed25519; t=1689447233; 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=rN7iXgHdNfoVTGsKEMlM6qhA1C0OhaHzC+3XBqWokqM=; b=+mXK0HAm21mj2g3flnXhM/kuVloOtSTQJd3/Y+ZO6agZVwZtFaRZLjGgxErCwRwNTikJWj JChxhkeFZob60KAQ== 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 7463E13A23; Sat, 15 Jul 2023 18:53:53 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id UIB4G0HrsmQCBwAAMHmgww (envelope-from ); Sat, 15 Jul 2023 18:53:53 +0000 From: Thomas Zimmermann To: deller@gmx.de, javierm@redhat.com, geert@linux-m68k.org, dan.carpenter@linaro.org 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-hyperv@vger.kernel.org, linux-omap@vger.kernel.org, linuxppc-dev@lists.ozlabs.org, kvm@vger.kernel.org, Thomas Zimmermann , Miguel Ojeda , Sui Jingfeng Subject: [PATCH v4 18/18] fbdev: Document that framebuffer_alloc() returns zero'ed data Date: Sat, 15 Jul 2023 20:52:00 +0200 Message-ID: <20230715185343.7193-19-tzimmermann@suse.de> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230715185343.7193-1-tzimmermann@suse.de> References: <20230715185343.7193-1-tzimmermann@suse.de> MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, 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: 1771514039880442676 X-GMAIL-MSGID: 1771514039880442676 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 Reviewed-by: Sui Jingfeng Cc: Helge Deller --- 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. *