Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 50484ECAAA1 for ; Mon, 31 Oct 2022 19:33:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:Message-Id:Date:Subject:Cc :To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=DnqgPThhw1z2cROFm28IEvA2ef2FpYRKpw0pwqlc2b4=; b=xFkaBi2cpJXuPk +/quPEu+utZkiEEN3AwZxqtgliQGqP8ccj3hZUpo7q8LS3FOXzEIGIe1pm2D2sBYvaApx2fyaiEfZ o0HoB6iDgHhV4OBQlf7kHiZSmhjWkpahu93ylLwUbU3w/UdTDNtojHBf9VNKTUwVvKyrAiDVZbLnM OE9uj0wTmANjM4YchU7akn/mu7zvkG38XW9lEWdPCgn3ZiiKXIaW/H15Hmy1kCl2SN9hOWhvA1aPH JV3+Y8AnJL0wLD3AGJzdxgGtmDDe3h8feeWR64Llsvwja6TjEd1mN1KdUnrDUdJxNh24RSAGJxywF rfTlj4HUPFyL/FBkG+cA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1opaX0-00EEcz-CL; Mon, 31 Oct 2022 19:33:10 +0000 Received: from dfw.source.kernel.org ([139.178.84.217]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1opaWy-00EEcK-00 for linux-arm-kernel@lists.infradead.org; Mon, 31 Oct 2022 19:33:09 +0000 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 4110861405; Mon, 31 Oct 2022 19:33:07 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 02C59C433D6; Mon, 31 Oct 2022 19:33:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1667244786; bh=qwGIoqCWokK3OviV0yNOMOGIIfmzU5aeoqSMuXMNfoM=; h=From:To:Cc:Subject:Date:From; b=utnAsDnP75HzWheeFWr6pEhU+jF7pEcVkFrnTO7QH0jPoBfTiTMp8LuSKodduZxk7 +GC2cwlq8N5ppqNIyWrCQXKXWLIk7xP1Nq0L+bz+ETjJwwOlILPMj/9Y+tp6wMFNWJ F1kRyECdukbpyGLmu9QZCXm8X2tIPI2oCM4GdlqgTanoRpNSMtZvGFVYMmg9eSiFLA r/vI6lxxpeCk02cNOZboA8LYjyjmLvT9l+JbGa9qp8oo0rqTDMzL84mvFPIV8h76Xa 5cLb92Zfg4WJUMVc9ZISKDQDXXxi28aK56YvPhAZdUPNmhuv/Vd5KqfAVaGXB4NfxJ Y1sAy2yuQk7lA== From: Mark Brown To: Catalin Marinas , Will Deacon Cc: Szabolcs Nagy , linux-arm-kernel@lists.infradead.org, Mark Brown Subject: [PATCH v1] arm64/signal: Document our convention for choosing magic numbers Date: Mon, 31 Oct 2022 19:24:50 +0000 Message-Id: <20221031192450.826159-1-broonie@kernel.org> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1280; i=broonie@kernel.org; h=from:subject; bh=qwGIoqCWokK3OviV0yNOMOGIIfmzU5aeoqSMuXMNfoM=; b=owEBbAGT/pANAwAKASTWi3JdVIfQAcsmYgBjYCEBJ23IP/4KMGjt/oUw7O/pIohO96SpRfs8FaGX PyeY7ICJATIEAAEKAB0WIQSt5miqZ1cYtZ/in+ok1otyXVSH0AUCY2AhAQAKCRAk1otyXVSH0GTBB/ jNY23a06q0KcatEoa1o8cJppeM4jYlUfn5AUJjd532aQC/HjaCyvpLygHkV9MAf7xha9SLjOxh5vOu YyqXvvuxH07/tZtOquaSZ1Co/G/EGecuw8DFnR1cAdD5qBVMQZZ2phscECoQ/mWroHVYuCEZGVjOkr hmpOJFdyjrOGxNPof4IimOrVKNe8u6uoTgf3M77cVkbj9R2uKVJYR2blwrcHILSFscLUySc73TXbrZ geKT6ysI61jXHD3Jt/E9jsGymiCPWRCT7qzMWBkFJOKVmkhMuW14bZOh24c1yDbZ1Y6kB25DGTmlvM XNKDR6dnrMrtJesbBskgv6NAJTltk= X-Developer-Key: i=broonie@kernel.org; a=openpgp; fpr=3F2568AAC26998F9E813A1C5C3F436CA30F5D8EB X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20221031_123308_093407_D8777704 X-CRM114-Status: GOOD ( 12.04 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Szabolcs Nagy has pointed out that most of our signal frame magic numbers are chosen to be meaningful ASCII when dumped to aid manual parsing. This seems sensible since it might help someone parsing things out, let's document it so people implementing new signal contexts are aware of it and are more likely to follow it. Signed-off-by: Mark Brown --- arch/arm64/include/uapi/asm/sigcontext.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/arch/arm64/include/uapi/asm/sigcontext.h b/arch/arm64/include/uapi/asm/sigcontext.h index 4aaf31e3bf16..32db6c6adc94 100644 --- a/arch/arm64/include/uapi/asm/sigcontext.h +++ b/arch/arm64/include/uapi/asm/sigcontext.h @@ -62,6 +62,11 @@ struct sigcontext { * context. Such structures must be placed after the rt_sigframe on the stack * and be 16-byte aligned. The last structure must be a dummy one with the * magic and size set to 0. + * + * Note that the values allocated for use as magic should be chosen to + * be meanigful in ASCII to aid manual parsing, ZA doesn't follow this + * convention due to oversight but it should be observed going + * forwards. */ struct _aarch64_ctx { __u32 magic; base-commit: 30a0b95b1335e12efef89dd78518ed3e4a71a763 -- 2.30.2 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel