From patchwork Fri Nov 18 17:09:41 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlos Bilbao X-Patchwork-Id: 22400 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp312697wrr; Fri, 18 Nov 2022 09:14:32 -0800 (PST) X-Google-Smtp-Source: AA0mqf40yaWr+lgdt95Nmbq+WKgSg1tdV9/tz5igqS5Ql0FOKgi8l1wU3g47gM1AM/M9MCC2GdMq X-Received: by 2002:a17:906:350e:b0:7ae:f441:6ade with SMTP id r14-20020a170906350e00b007aef4416ademr6808384eja.436.1668791672667; Fri, 18 Nov 2022 09:14:32 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1668791672; cv=pass; d=google.com; s=arc-20160816; b=lIHDdROBiNqdZnzz2GUQ1USUp9mUUhZyt3DJQhyCpcV06rN6e5jRZH9gw7p73948Tb uGTzW+t0N6bSU6++PBcWbNeVHtk+HTvx/UGRIdRKFFojcc+aGJRSU00ipfbn7wpaYB15 zJBR0QT+R/bU4QQjrTI7Gc5z4f0rJcDaUKrttMnuqNKs9cKGP01GFEGrrhdImsr8T1y4 D2pnNOjJPcfEUI0/fjqjmenPwGNvDxbg7UB16e452+V26AnMYzMpqS+00b5EY8Dfv6zG pxNk0ah9dlItnAVDiiEk7NJkIaUeQaCUjC/e0Z0ZaqCKLuBEuLn3+Xs1OSsbXDU4QS7o kH2w== ARC-Message-Signature: i=2; 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; bh=pl1UoATgwF1IFnrp+n1iTJ1Errjm4cUStff74u+Lz04=; b=RTcIKnusEMYY5BkdqDM/zuRUj2zJnmKjpHvd4NwzZoH4xa8VKIlJlhL2kHmhsPm0c9 pbI3Xw9fvWewRSZdVxK3KnMYVy/0BhG1fJjmmN62/bA7LxlvsyYM+eWTSM9sE58kD445 f4uu+KizskjCcmC6Sn1OHJ1nrL8SZAl16RkBxSzWkllp4mIhaKW0gdlMni6rUJMKGJuf nGTxI7Gd3cC31GBU9Ra6hTkTnEtRTwkvN12rnUyzS0vsBGNyF/mvSM7ptrr7nru8iwI1 jrZzVwe62hM4K1KeXnMFDP4mR7lBb37tsAjEM+BUTkcBLbVQQvky+uprWny1x6XZ9K9t 1L9A== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b=YeTn5BZk; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); 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=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id t32-20020a056402242000b0045fd458991fsi3368253eda.428.2022.11.18.09.14.04; Fri, 18 Nov 2022 09:14:32 -0800 (PST) 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=@amd.com header.s=selector1 header.b=YeTn5BZk; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); 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=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S242468AbiKRRJ6 (ORCPT + 99 others); Fri, 18 Nov 2022 12:09:58 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46000 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S241913AbiKRRJv (ORCPT ); Fri, 18 Nov 2022 12:09:51 -0500 Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2052.outbound.protection.outlook.com [40.107.93.52]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B25AB8C7A3; Fri, 18 Nov 2022 09:09:47 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lYMTvz+sGiQvMi4TnBcyMouwGsYsbAy+amNVpahdKSwrLFUAyMcJ7zzPFHIxJXxfYqjqXlZxjTDJdWGn3hwzJVEofD6bY4++TEIj61CddN3I3tXVDMuG8gx1VMC3M3uIbqkOtUksi62IroBSueJRq2VPEIVoVQ8Uq39oaMYXsDPYAzcPJsZb2TBZySAnkqcHluop23WBx/dHEou7042hsgjki1UPXr7fjbU9bs0E2IR95TAWZKibxh1QipCZBklxpuuaUETw1EiskOp4nwJ6NSoci1HcIRFNF9pjy0OkYA/iwxNPr2w4+Tkssp/9IwjPe4na0fF514MIGe9wxPgQog== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=pl1UoATgwF1IFnrp+n1iTJ1Errjm4cUStff74u+Lz04=; b=X0hK5KmeTPjFf3B3NfNhSZu6XZKzI1X+hhz/FnIMfFMt8ZDO48Mpv8LQeJwfD5xTot4sPoYZO81FKYQ4rEgfxUtmmYkU/Cjp9yiEwlqjSKyYUppojjwaH4fOGnfzmQN3ndhFBuT10d98hNsNP3MGBYHqfnR46kcRm4GMlt09pZrIVQe9ElIYdVN0nHUSvAFjIJ93SaG+xUVws3ILP4rIYPloHN5FtxYF2BSJN6S5ygAbGv5OkHBF69iKyuLOUydIviO/n7QOfHsPaEPLYw5zxQQHm5uHd+WCffLUQAqddREeZQj3wBKP4CjW+UjMF2uBHxqGL62YbwpVOmmduQTQ/Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=lwn.net smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=pl1UoATgwF1IFnrp+n1iTJ1Errjm4cUStff74u+Lz04=; b=YeTn5BZkBsxyxDtsUmueUkckxb/JPDHvRJzFkA5fDni1oNey9kh9olpLxtp5kbQGmTTAJpl10sfVASvx2s+yL8cSBW5Hsk4Lz7jslNXPuWZS/vVEff06VJ/ztRjOX5DxVkgYjXhLOmRMLCPhHmmfaOVK9A6987FyVp2ZdQTEuLQ= Received: from BN0PR04CA0046.namprd04.prod.outlook.com (2603:10b6:408:e8::21) by PH0PR12MB7009.namprd12.prod.outlook.com (2603:10b6:510:21c::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5834.9; Fri, 18 Nov 2022 17:09:45 +0000 Received: from BN8NAM11FT116.eop-nam11.prod.protection.outlook.com (2603:10b6:408:e8:cafe::31) by BN0PR04CA0046.outlook.office365.com (2603:10b6:408:e8::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.20 via Frontend Transport; Fri, 18 Nov 2022 17:09:45 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB03.amd.com; pr=C Received: from SATLEXMB03.amd.com (165.204.84.17) by BN8NAM11FT116.mail.protection.outlook.com (10.13.176.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.5834.8 via Frontend Transport; Fri, 18 Nov 2022 17:09:45 +0000 Received: from SATLEXMB07.amd.com (10.181.41.45) by SATLEXMB03.amd.com (10.181.40.144) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Fri, 18 Nov 2022 11:09:44 -0600 Received: from SATLEXMB03.amd.com (10.181.40.144) by SATLEXMB07.amd.com (10.181.41.45) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Fri, 18 Nov 2022 09:09:44 -0800 Received: from iron-maiden.amd.com (10.180.168.240) by SATLEXMB03.amd.com (10.181.40.144) with Microsoft SMTP Server id 15.1.2375.34 via Frontend Transport; Fri, 18 Nov 2022 11:09:43 -0600 From: Carlos Bilbao To: , CC: , , , , , "Carlos Bilbao" Subject: [PATCH 1/2] docs: Update maintainer of kernel-docs.rst Date: Fri, 18 Nov 2022 11:09:41 -0600 Message-ID: <20221118170942.2588412-2-carlos.bilbao@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20221118170942.2588412-1-carlos.bilbao@amd.com> References: <20221118170942.2588412-1-carlos.bilbao@amd.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT116:EE_|PH0PR12MB7009:EE_ X-MS-Office365-Filtering-Correlation-Id: 8e6d901b-9edf-4080-2f57-08dac987b0d9 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: G2aOV6NkxjrIlrZqaIFv87+aMgrb+cs1piJigu8MCNLgbniS6nORRMmzjt2R3kx6lARMvyDUkgVLIC5ZLC1VL/dwpw+SDD78EsXBq6xSgs29bFixK+maxmq4GIqP9pUSBKeUKz/7LlyFTeFcGMmz3nDEACfuutqEbiwrFnkN1lQVgcU9cN1u+KGm5NPIjEZfMtUNAD38q7kbC36DTEMVWCISklv6TTkWhKF3E4Mu9DAmq9KC5fBGSiP+HycY4Rj/K3TXfLIAGWbFkO/d89A0LYKZV26RdZclaiAvY9G1iPEfZu+SN/1LaWn6uhOZwBV/CQ9UeUE+wsfhcQf7HSRZPnQfbyvXxy7wkIlV9XNMcxww2rBNGhzVEpg06+ViQxwyy/pPpS4c/fSiklYo5TreT6mPeAaSzV2i7pEZivw1PON9qrISbex/6GB74cjSzI3o8t7r2YcRInla12aGviQsEzSxLwctdUEY1ODi3liUlByK7feQWRAl4gOLYAG38C5gOmV5Us4jXBwvoyM3PZDaBIOk94sxhvUGUwDSLzsvOsw37MEXRaBHoIXgzOYkNLLP+n57RGW/nz38uIv5hrnhK9B99BNT00xwd7cUcVEVY1oR4GeuZTI29TBZYcO2f3EMEYiI3f8orCrfeEO7/dPTttEgI0tVvxXNRbZGYmi2i+mItrRH7ETvgjeuDm3o7RU1c5LT7ntqRD3wBtqR4j26EoEYuvQLDQG1GD96BniwXtpDYLWbYGZm8av5bIW+LjES3jMyAqOIdJG+VB0nLOpLsQ== X-Forefront-Antispam-Report: CIP:165.204.84.17;CTRY:US;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:SATLEXMB03.amd.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230022)(4636009)(346002)(376002)(39860400002)(136003)(396003)(451199015)(36840700001)(46966006)(40470700004)(86362001)(966005)(478600001)(82740400003)(44832011)(82310400005)(40460700003)(7696005)(83380400001)(316002)(186003)(2616005)(36756003)(8936002)(2906002)(26005)(36860700001)(110136005)(54906003)(41300700001)(81166007)(15650500001)(426003)(47076005)(40480700001)(356005)(1076003)(336012)(70586007)(8676002)(70206006)(5660300002)(4326008)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Nov 2022 17:09:45.0669 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 8e6d901b-9edf-4080-2f57-08dac987b0d9 X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d;Ip=[165.204.84.17];Helo=[SATLEXMB03.amd.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT116.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR12MB7009 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_NONE, RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS 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: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749854897027639763?= X-GMAIL-MSGID: =?utf-8?q?1749854897027639763?= Add name and email for new maintainer of the Index of Further Kernel Documentation (document process/kernel_docs.rst). Also remove line that keeps record of last update of the text -this information is already available elsewhere. Signed-off-by: Carlos Bilbao --- Documentation/process/kernel-docs.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/process/kernel-docs.rst b/Documentation/process/kernel-docs.rst index 306ad373a002..e1fb1139548b 100644 --- a/Documentation/process/kernel-docs.rst +++ b/Documentation/process/kernel-docs.rst @@ -3,6 +3,8 @@ Index of Further Kernel Documentation ===================================== +Current Maintainer: Carlos Bilbao + Initial Author: Juan-Mariano de Goyeneche (; email address is defunct now.) @@ -614,7 +616,5 @@ Miscellaneous ------- -Document last updated on Tue 2016-Sep-20 - This document is based on: https://www.dit.upm.es/~jmseyas/linux/kernel/hackers-docs.html From patchwork Fri Nov 18 17:09:42 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Carlos Bilbao X-Patchwork-Id: 22401 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp312698wrr; Fri, 18 Nov 2022 09:14:33 -0800 (PST) X-Google-Smtp-Source: AA0mqf6Ga5/86JP79XAnLQpMWTa6RPPGr4bNMVqK/XalsOyPr7rO51YpvIj3vgLEEZqX7ZXti4w6 X-Received: by 2002:a17:906:eb8e:b0:7b2:a2c3:2ff0 with SMTP id mh14-20020a170906eb8e00b007b2a2c32ff0mr6117103ejb.561.1668791672904; Fri, 18 Nov 2022 09:14:32 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1668791672; cv=pass; d=google.com; s=arc-20160816; b=GLlPeJ5fuTwcBX77pYZIfb8/oYnY15/jrzAmVIgDTXca1tvsnEkS81l9nYEikaEq1k lW9XGjOVOj9MCkpsV2CnvNiWGyVWuFnfK86Rb22jaqe8AySVDEbmh2xAda5acPMgNsnL 40kyoEEzK1bTR04kLdUnGAtnGGTTusEgi7+pEtpPhdGLkMjbkN+guclObvIP88Pz22ZQ qFKPfCR+c5utpDsukWKBL0O3UR6aGs+RVCrRrofzn5jPL53lVkPEc41lM0jH7rzC5YC1 50Iy0ZwYVAlU49A+zP1Vf4hL90P18Q2h/JN8M8/j5/kcAPi6HorbCs1JKxB6vvGVtY7o m9oQ== ARC-Message-Signature: i=2; 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; bh=fEjrl7qhtj57iyevLSnBnDY2MNTxP4fyXSqcLRGW2L4=; b=o8UrWAi1B1uEuatKZurk1G9KEWTAzDISHdneqgz4KL8NyA/GN8qXIWz1kfW6VqLVQ1 izHx8QabVkv2e1CorybP87fUQhio/Pqgc38jYNk7gtJ9xkKGJlCAmSm5/eZm/qxwr4EN +wIUHEOFWpAGrT/LSsCAso1tpVIJIuSBNIVkwfyFfB6fHlz/Tmoskp+TlMx/Q5VjMRNx Ad3isv5xDJhnVeNI1xNrXkz+nZ6rA9ye27qWj92b2WPWMIBay6T9GS1PNxo2QiaJqBj7 jxd/axJ9ceuX517UhoFHsbCe5XY6QQ//7aaFcNgq3WIVR5s2OOCGa4T71SKP6fRmg20z HD+Q== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b=XBIb6m0s; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); 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=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ht21-20020a170907609500b007b299050723si3627802ejc.410.2022.11.18.09.14.05; Fri, 18 Nov 2022 09:14:32 -0800 (PST) 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=@amd.com header.s=selector1 header.b=XBIb6m0s; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); 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=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S241712AbiKRRKF (ORCPT + 99 others); Fri, 18 Nov 2022 12:10:05 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45998 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S241673AbiKRRJx (ORCPT ); Fri, 18 Nov 2022 12:09:53 -0500 Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2061d.outbound.protection.outlook.com [IPv6:2a01:111:f400:7eaa::61d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A73B1898D8; Fri, 18 Nov 2022 09:09:48 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=DGxWH5UrU6M1RUTwOQwXYnvmamLuExV/tbHuZkvT+s4CIGynxAtXN8P/9irGeLiab0fIcbzk02wR4+n+jiak+mcGPpdQvPjI0dsltkU4yYmMcnkJ4vON/j36n282NctWz8NeDl+POIVRzRlsRM/QF2SNMlppWPIarRfJZH4pdZQdpg4ck1KsqEzlpPYN6qPQQi2tF3LJV5QTjn0pRM4xla55u+Ox6IoCjA43XVrg/OeQElBxBIOJ3tj8FkC7iGKJOGkhRMpJhPPRiP48nIntboJEEoQ1X7iqw43QO9kGkdQ8HbJVhTZucz7wQVgxq0mSnA4G4gvIou1Xx5SlaNo7xQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=fEjrl7qhtj57iyevLSnBnDY2MNTxP4fyXSqcLRGW2L4=; b=lGbiMl6xNgtB/qPervU6LmaPX3zoVoBxXfO3q4uKSIoIc+pPb3trIlS6sJk23S3RhIyUEC1XYRDEO7KYjzGok3XfrCM+DNpdUpg/6F7f0gue4QGMd8doEZzxTV79TLjoFbtZcpId+KDeM7mXkj2hdveHRul7F5bG5xWWk1ma5Y6jGVjoOaSuDJZjclKAx5Kelo1cOnbDCMkscMKL11it83ZTpzH24NE4f/L5VM4DLQLM9E/vXlhR94osYRCjgEZL6lQamiZXvCDRKEeknVHrbUAAWvXcBt5crG3eO0m1CJqnkBpe49obHpNZMS1QZilHu2x8kkFLOHeWnnxNWJPQEg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=lwn.net smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=fEjrl7qhtj57iyevLSnBnDY2MNTxP4fyXSqcLRGW2L4=; b=XBIb6m0s+aIrXojwN6KKm2s/7+LDiyXzAn8t2WYyJq5k9hqxSBgASRNTSUmHgRL2fpBkdm5PkD0RIt7Tu6Kc65L5ok2PkJSZM0o7+Vt1Y170EIbGFT5kvXdG5HKUI+yn489z5JfyIw7egABnWpE0kq4i+YOcZc7YnxWF3GQqJ/s= Received: from BN0PR04CA0057.namprd04.prod.outlook.com (2603:10b6:408:e8::32) by DM4PR12MB6181.namprd12.prod.outlook.com (2603:10b6:8:a9::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5834.9; Fri, 18 Nov 2022 17:09:45 +0000 Received: from BN8NAM11FT116.eop-nam11.prod.protection.outlook.com (2603:10b6:408:e8:cafe::ec) by BN0PR04CA0057.outlook.office365.com (2603:10b6:408:e8::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5834.9 via Frontend Transport; Fri, 18 Nov 2022 17:09:45 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB03.amd.com; pr=C Received: from SATLEXMB03.amd.com (165.204.84.17) by BN8NAM11FT116.mail.protection.outlook.com (10.13.176.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.5834.8 via Frontend Transport; Fri, 18 Nov 2022 17:09:45 +0000 Received: from SATLEXMB03.amd.com (10.181.40.144) by SATLEXMB03.amd.com (10.181.40.144) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Fri, 18 Nov 2022 11:09:44 -0600 Received: from iron-maiden.amd.com (10.180.168.240) by SATLEXMB03.amd.com (10.181.40.144) with Microsoft SMTP Server id 15.1.2375.34 via Frontend Transport; Fri, 18 Nov 2022 11:09:44 -0600 From: Carlos Bilbao To: , CC: , , , , , "Carlos Bilbao" Subject: [PATCH 2/2] docs/sp_SP: Add process kernel-docs translation Date: Fri, 18 Nov 2022 11:09:42 -0600 Message-ID: <20221118170942.2588412-3-carlos.bilbao@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20221118170942.2588412-1-carlos.bilbao@amd.com> References: <20221118170942.2588412-1-carlos.bilbao@amd.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT116:EE_|DM4PR12MB6181:EE_ X-MS-Office365-Filtering-Correlation-Id: 66f164a9-6601-4549-3def-08dac987b12a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: rUDb46E/zCtC1rPDoRz3JhrZMAjtmYDUP4UlBKQxY0aHog5oQnscVnjItBjIPvSHM/vfhD2GwXuEsRY4/CN+qQ3WWZdBoz45Y/gZhEYrg5FlJT+3ZMKlrh0LBpMxp6g/h0xf0r19YrRy7kppwT62T4Zj9qutqhp5sVS96+WzNIvnkueYxfZkfEPQGc+rrAfpLDnD0S93/JLAdOw6OWp4AGE87fJmiWLmOpcmzuT0nZOkeJzm7lbASkqZcm21xBL6SxPvKPB11qPm4jVjAzlCvEc1qK5GJrPPcnEri8Vqhi2xrRSeFapMj3sNEkOI4jhlCQMhcQjIKmNdp5AJW+X6jVUeE5LA2YzUq9z/xXbhVwF68jDZUAyNgCE5yrRlkjmgW8Arv8msx35VfmBeyqAQ9yA73Tn3uIAHyeosyMUXhSnL/wZwOujGGlS2vGt/uGNwbB+qdjqOW2Z9yFEyCnfyLAVe20Ime8slBNBkp+sxosEH5isDjjH3y3vbPDKGDC0S3BZOzoPbWbNA5I5C5f78IVep3S+eWIlAKCKMwtLiCFn8DUp1NPwcOckAbR35yGPh13keqs2Yeh74Ac3YLVyyt6Q9iwITlV2R0eqmQJggyrs3OFk5mWsFyuBR2HTnAeZRc8LnSYFvebC2kYnpV9zoR8B8n/l22hsNJSeJErgqi5iVsT25wCz9f/x0fGOisRfD3P5sHOI1MU3shO3HRl9yVCP60OkwDd9Y+5qrk6uMIcHPAilbqHGA1RVln+SFeAfcu6LvdJM0WmfhOlfoT+Vp+iHluMy2ac5Hzaq3+lEGDWXniN4wXB5MDrVBy5Ng+nckOxpzjQhxLx7g5PQ2pSeak+/iUYRVYbx+vNR/nm4wh8U= X-Forefront-Antispam-Report: CIP:165.204.84.17;CTRY:US;LANG:es;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:SATLEXMB03.amd.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230022)(4636009)(376002)(396003)(346002)(136003)(39860400002)(451199015)(46966006)(40470700004)(36840700001)(83380400001)(66899015)(15188155005)(86362001)(40460700003)(478600001)(110136005)(26005)(7696005)(966005)(356005)(36756003)(81166007)(16799955002)(40480700001)(70586007)(82310400005)(36860700001)(186003)(1076003)(426003)(336012)(2616005)(66574015)(47076005)(8936002)(70206006)(30864003)(44832011)(41300700001)(4326008)(82740400003)(8676002)(5660300002)(316002)(54906003)(2906002)(36900700001)(562404015)(19623215001);DIR:OUT;SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Nov 2022 17:09:45.5825 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 66f164a9-6601-4549-3def-08dac987b12a X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d;Ip=[165.204.84.17];Helo=[SATLEXMB03.amd.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT116.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR12MB6181 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_PASS,SPF_PASS 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: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749854897606696198?= X-GMAIL-MSGID: =?utf-8?q?1749854897606696198?= Translate Documentation/process/kernel-docs.rst into Spanish. Signed-off-by: Carlos Bilbao --- Documentation/translations/sp_SP/index.rst | 2 +- .../translations/sp_SP/kernel-docs.rst | 643 ++++++++++++++++++ 2 files changed, 644 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/sp_SP/kernel-docs.rst diff --git a/Documentation/translations/sp_SP/index.rst b/Documentation/translations/sp_SP/index.rst index 519c5ef9ac9d..c60c6947d2b4 100644 --- a/Documentation/translations/sp_SP/index.rst +++ b/Documentation/translations/sp_SP/index.rst @@ -80,7 +80,7 @@ Traducciones al español howto submitting-patches coding-style + kernel-docs .. include:: ./memory-barriers.txt :literal: - diff --git a/Documentation/translations/sp_SP/kernel-docs.rst b/Documentation/translations/sp_SP/kernel-docs.rst new file mode 100644 index 000000000000..b0496e58ad86 --- /dev/null +++ b/Documentation/translations/sp_SP/kernel-docs.rst @@ -0,0 +1,643 @@ +.. include:: ./disclaimer-sp.rst + +:Original: :ref:`Documentation/process/kernel-docs.rst ` +:Translator: Carlos Bilbao + +.. _sp_kernel_docs: + +Índice de documentación adicional del kernel +============================================ + +Actual maintainer: Carlos Bilbao + +Autor Inicial: Juan-Mariano de Goyeneche (; +la dirección de correo electrónico ya no existe). + +La necesidad de un documento como este se hizo evidente en la lista de +correo de linux-kernel cuando las mismas preguntas, solicitando sugerencias +e información, aparecieron una y otra vez. + +Afortunadamente, a medida que más y más gente accede a GNU/Linux, más +desarrolladores se interesan por el kernel. Sin embargo, leer las fuentes +no siempre es suficiente. Es fácil entender el código, pero se pierden los +conceptos, la filosofía y decisiones de diseño detrás de dicho código. + +Desafortunadamente, no existen muchos documentos disponibles para que los +principiantes comiencen. Y, aunque existieran, no habría ningún lugar +"conocido" que les pudiera seguir la pista. Estas líneas tratan de cubrir +esta carencia. + +POR FAVOR, si conoce algún documento que no figura aquí, o si escribe un +nuevo documento, incluya una referencia aquí, siguiendo el proceso de envío +de parches del kernel. Cualquier corrección, idea o comentario también es +bienvenida. + +Todos los documentos se catalogan con los siguientes campos: el "Título", +el "Autor"/es, la "URL" donde se encuentran, algunas "Palabras clave" +útiles para buscar temas específicos, y una breve "Descripción" del +documento en cuestión. + +.. note:: + + Los documentos de cada sección en este documento están ordenados por su + fecha de publicación, del más reciente al más antiguo. + +Documentos en el árbol del kernel Linux +----------------------------------------- + +Los libros de Sphinx deben compilarse con ``make {htmldocs | pdfdocs | epubdocs}``. + + * Título: **linux/Documentation** + + :Autor: Many. + :Ubicación: Documentation/ + :Palabras Clave: archivos de texto, Sphinx. + :Descripción: Documentación que viene con las fuentes del kernel, + dentro del directorio Documentation. Algunas páginas de este documento + (incluido este documento en sí) se han trasladado allí, y podrían + estar más actualizadas que la versión web. + +Documentos en línea +------------------- + + * Título: **Linux Kernel Mailing List Glossary** + + :Autor: various + :URL: https://kernelnewbies.org/KernelGlossary + :Fecha: rolling version + :Palabras Clave: glosario terminos, linux-kernel. + :Descripción: De la Introducción: "This glossary is intended as + a brief description of some of the acronyms and terms you may hear + during discussion of the Linux kernel". + + * Título: **Tracing the Way of Data in a TCP Connection through the Linux Kernel** + + :Autor: Richard Sailer + :URL: https://archive.org/details/linux_kernel_data_flow_short_paper + :Fecha: 2016 + :Palabras Clave: Linux Kernel Networking, TCP, tracing, ftrace + :Descripción: A seminar paper explaining ftrace and how to use it for + understanding linux kernel internals, + illustrated at tracing the way of a TCP packet through the kernel. + :Resumen: *Este breve documento describe el uso del framework de + tracing ftrace como una herramienta para comprender un sistema + Linux en ejecución. Habiendo obtenido un "trace-log", un hacker del + kernel puede leer y comprender código fuente con más determinación + y contexto. En un ejemplo detallado, este enfoque se demuestra al + rastrear datos en una conexión TCP a través del kernel. Finalmente, + tal registro se utiliza como base para una más exacta exploración + y descripción conceptual de la implementación de Linux TCP/IP.* + + * Título: **The Linux Kernel Module Programming Guide** + + :Autor: Peter Jay Salzman, Michael Burian, Ori Pomerantz, Bob Mottram, + Jim Huang. + :URL: https://sysprog21.github.io/lkmpg/ + :Fecha: 2021 + :Palabras Clave: modules, GPL book, /proc, ioctls, system calls, + interrupt handlers . + :Descripción: Un muy buen libro GPL sobre el tema de la programación + de módulos. Muchos ejemplos. Actualmente la nueva versión está + siendo mantenida activamente ent https://github.com/sysprog21/lkmpg. + + * Título: **On submitting kernel Patches** + + :Autor: Andi Kleen + :URL: http://halobates.de/on-submitting-kernel-patches.pdf + :Fecha: 2008 + :Palabras Clave: patches, review process, types of submissions, basic rules, case studies + :Descripción: Este documento brinda valiosa experiencia sobre qué + tipos de parches hay y la probabilidad de que se acepten. + :Resumen: + [...]. En este artículo se examinan algunos problemas comunes para + presentar cambios más grandes y algunas estrategias para evitar + problemas. + + * Título: **Linux Device Drivers, Third Edition** + + :Autor: Jonathan Corbet, Alessandro Rubini, Greg Kroah-Hartman + :URL: https://lwn.net/Kernel/LDD3/ + :Fecha: 2005 + :Descripción: Un libro de 600 páginas que cubre la API (2.6.10) + programación de drivers y temas hacker del kernel en general. + Disponible bajo licencia Creative Commons Attribution-ShareAlike 2.0. + :note: También puede :ref:`comprar una copia en O'Reilly o en otro lugar `. + + * Título: **Writing an ALSA Driver** + + :Autor: Takashi Iwai + :URL: https://www.kernel.org/doc/html/latest/sound/kernel-api/writing-an-alsa-driver.html + :Fecha: 2005 + :Palabras Clave: ALSA, sonido, tarjeta de sonido, driver, bajo nivel, hardware. + :Descripción: Advanced Linux Sound Architecture para desarrolladores, + tanto en el kernel como a nivel de usuario. ALSA era la aquitectura + de sonido del kernel de Linux en la versión kernel 2.6. + + * Título: **Linux PCMCIA Programmer's Guide** + + :Autor: David Hinds. + :URL: http://pcmcia-cs.sourceforge.net/ftp/doc/PCMCIA-PROG.html + :Fecha: 2003 + :Palabras Clave: PCMCIA. + :Descripción: "Este documento describe cómo escribir drivers kernel + para la interfaz Card Services de la tarjeta PCMCIA de Linux. + También describe cómo escribir utilidades en modo usuario para + comunicarse con Card Services. + + * Título: **How NOT to write kernel drivers** + + :Autor: Arjan van de Ven. + :URL: https://landley.net/kdocs/ols/2002/ols2002-pages-545-555.pdf + :Fecha: 2002 + :Palabras Clave: driver. + :Descripción: Programming bugs and Do-nots in kernel driver development + :Resumen: *Quitando algunos tutoriales, artículos y libros que hacen + una introducción sobre cómo escribir drivers del kernel de Linux, + desafortunadamente, las cosas que NO se deben hacer en código del + kernel de Linux son solo un apéndice menor o, más comúnmente, + están completamente ausentes. Este trabajo intenta tocar + brevemente las áreas en que se encuentran los errores e + inconvenientes más comunes y graves.* + + * Título: **Global spinlock list and usage** + + :Autor: Rick Lindsley. + :URL: http://lse.sourceforge.net/lockhier/global-spin-lock + :Fecha: 2001 + :Palabras Clave: spinlock. + :Descripción: Este es un intento de documentar tanto la existencia + como el uso de spinlocks en el kernel de Linux 2.4.5. Lista + exhaustiva de spinlocks que muestra cuándo se usan, qué funciones + acceden a ellos, cómo se adquiere cada bloqueo, en qué condiciones + se poseen, si pueden ocurrir interrupciones o no mientras se + poseen... + + * Título: **A Linux vm README** + + :Autor: Kanoj Sarcar. + :URL: http://kos.enix.org/pub/linux-vmm.html + :Fecha: 2001 + :Palabras Clave: memoria virtual, mm, pgd, vma, flags de pagina, pagina, + cache, swap cache, kswapd. + :Descripción: Breves descripciones y definiciones relacionandas con + la implementación de memoria virtual en Linux. + + * Título: **Video4linux Drivers, Part 1: Video-Capture Device** + + :Autor: Alan Cox. + :URL: http://www.linux-mag.com/id/406 + :Fecha: 2000 + :Palabras Clave: video4linux, driver, captura de video, dispositivos + de captura, driver de camara, video. + :Descripción: El título (dispositivo de captura de video) lo dice todo. + + * Título: **Video4linux Drivers, Part 2: Video-capture Devices** + + :Autor: Alan Cox. + :URL: http://www.linux-mag.com/id/429 + :Fecha: 2000 + :Palabras Clave: video4linux, driver, captura de video, capture devices, + driver de camara, control, query capabilities, capability, facility. + :Descripción: El título (dispositivo de captura de video) lo dice todo. + + * Título: **Linux IP Networking. A Guide to the Implementation and Modification of the Linux Protocol Stack.** + + :Autor: Glenn Herrin. + :URL: http://www.cs.unh.edu/cnrg/gherrin + :Fecha: 2000 + :Palabras Clave: red, redes, protocol, IP, UDP, TCP, conexión, + socket, receiving, transmitting, forwarding, routing, paquetes, + módulos, /proc, sk_buff, FIB, tags, transmitir. + :Descripción: Excelente artículo dedicado a las redes IP de Linux, + explicando cualquier cosa, desde el kernel hasta el código de las + herramientas de configuración de espacio de usuario. Muy bueno + para obtener una visión general de la implementación de red del + kernel y entender todos los pasos que los paquetes siguen desde el + momento en que se reciben en el dispositivo de red hasta que se + envían a las aplicaciones. El kernel estudiado es de la versión + 2.2.14. Proporciona código para un ejemplo de "packet dropper". + + * Título: **How To Make Sure Your Driver Will Work On The Power Macintosh** + + :Autor: Paul Mackerras. + :URL: http://www.linux-mag.com/id/261 + :Fecha: 1999 + :Palabras Clave: Mac, Power Macintosh, porting, drivers, compatibility. + :Descripción: El título lo dice todo (driver en Mac). + + * Título: **An Introduction to SCSI Drivers** + + :Autor: Alan Cox. + :URL: http://www.linux-mag.com/id/284 + :Fecha: 1999 + :Palabras Clave: SCSI, device, driver. + :Descripción: El título lo dice todo (drivers SCSI). + + * Título: **Advanced SCSI Drivers And Other Tales** + + :Autor: Alan Cox. + :URL: http://www.linux-mag.com/id/307 + :Fecha: 1999 + :Palabras Clave: SCSI, device, driver, advanced. + :Descripción: El título lo dice todo (drivers SCSI avanzados). + + * Título: **Writing Linux Mouse Drivers** + + :Autor: Alan Cox. + :URL: http://www.linux-mag.com/id/330 + :Fecha: 1999 + :Palabras Clave: ratón, driver, gpm. + :Descripción: El título lo dice todo (drivers para el ratón en Linux). + + * Título: **More on Mouse Drivers** + + :Autor: Alan Cox. + :URL: http://www.linux-mag.com/id/356 + :Fecha: 1999 + :Palabras Clave: ratón, driver, gpm, races, asynchronous I/O. + :Descripción: El título todavía lo dice todo (mas sobre drivers para + el ratón en Linux).. + + * Título: **Writing Video4linux Radio Driver** + + :Autor: Alan Cox. + :URL: http://www.linux-mag.com/id/381 + :Fecha: 1999 + :Palabras Clave: video4linux, driver, radio, radio devices, dispositivos de radio. + :Descripción: El título lo dice todo (driver para radio Video4linux). + + * Título: **I/O Event Handling Under Linux** + + :Autor: Richard Gooch. + :URL: https://web.mit.edu/~yandros/doc/io-events.html + :Fecha: 1999 + :Palabras Clave: IO, I/O, select(2), poll(2), FDs, aio_read(2), readiness + event queues, colas de eventos. + :Descripción: De la Introducción: "I/O Event handling is about + how your Operating System allows you to manage a large number of + open files (file descriptors in UNIX/POSIX, or FDs) in your + application. You want the OS to notify you when FDs become active + (have data ready to be read or are ready for writing). Ideally you + want a mechanism that is scalable. This means a large number of + inactive FDs cost very little in memory and CPU time to manage". + + * Título: **(nearly) Complete Linux Loadable Kernel Modules. The definitive guide for hackers, virus coders and system administrators.** + + :Autor: pragmatic/THC. + :URL: http://packetstormsecurity.org/docs/hack/LKM_HACKING.html + :Fecha: 1999 + :Palabras Clave: syscalls, interceptar, ocultar, abusar, symbol table. + :Descripción: Interesante artículo sobre cómo abusar del kernel Linux + para interceptar y modificar syscalls, hacer archivos/directorios/procesos + invisibles, convertirse en root, secuestrar ttys, escribir virus + basados en módulos del kernel... y soluciones para que los + administradores eviten todos esos abusos. + :Notas: Para kernels 2.0.x. Da instrucciones para portarlo a kernels + 2.2.x. + + * Título: **Linux Virtual File System** + + :Autor: Peter J. Braam. + :URL: http://www.coda.cs.cmu.edu/doc/talks/linuxvfs/ + :Fecha: 1998 + :Palabras Clave: slides, VFS, inodo, superblock, dentry, dcache. + :Descripción: Conjunto de diapositivas, presumiblemente de una + presentación del layer Linux VFS. Cubre la versión 2.1.x, con + dentries y el dcaché. + + * Título: **The Venus kernel interface** + + :Autor: Peter J. Braam. + :URL: http://www.coda.cs.cmu.edu/doc/html/kernel-venus-protocol.html + :Fecha: 1998 + :Palabras Clave: coda, filesystem, venus, cache manager, sistemas de ficheros. + :Descripción: "This document describes the communication between + Venus and kernel level file system code needed for the operation + of the Coda filesystem. This version document is meant to describe + the current interface (version 1.0) as well as improvements we + envisage". + + * Título: **Design and Implementation of the Second Extended Filesystem** + + :Autor: Rémy Card, Theodore Ts'o, Stephen Tweedie. + :URL: https://web.mit.edu/tytso/www/linux/ext2intro.html + :Fecha: 1998 + :Palabras Clave: ext2, historia de linux fs, inode, directory, link, devices, + VFS, physical structure, performance, benchmarks, ext2fs library, + ext2fs tools, e2fsck, inodo, rendimiento, libreria, dispositivos. + :Descripción: Documento escrito por tres de los mejores hackers de ext2. + Cubre la historia de los sistemas de archivos de Linux, la + motivación de ext2, las características de ext2, diseño, estructura + física en disco, rendimiento, benchmarks, descripción de los pases + de e2fsck... De lectura obligada! + :Notas: Este artículo se publicó por primera vez el Proceedings of the + First Dutch International Symposium on Linux, ISBN 90-367-0385-9. + + * Título: **The Linux RAID-1, 4, 5 Code** + + :Autor: Ingo Molnar, Gadi Oxman and Miguel de Icaza. + :URL: http://www.linuxjournal.com/article.php?sid=2391 + :Fecha: 1997 + :Palabras Clave: RAID, MD driver. + :Descripción: artículo del Linux Journal Kernel Korner. + :Resumen: *Una descripción de la implementación de RAID-1, + personalidades RAID-4 y RAID-5 del driver de dispositivo MD en el + kernel Linux, proporcionando a los usuarios una capacidad de + almacenamiento secundaria de alto rendimiento y fiabilidad, usando + software*. + + * Título: **Linux Kernel Hackers' Guide** + + :Autor: Michael K. Johnson. + :URL: https://www.tldp.org/LDP/khg/HyperNews/get/khg.html + :Fecha: 1997 + :Palabras Clave: device drivers, files, VFS, kernel interface, character vs + block devices, hardware interrupts, scsi, DMA, access to user memory, + memory allocation, timers, archivos, interfaz del kernel, interrupciones. + :Descripción: Una guía diseñada para ayudarle a ponerse al día sobre + los conceptos que no son intuitivamente obvios, y para documentar + la estructuras interna de Linux. + + * Título: **Dynamic Kernels: Modularized Device Drivers** + + :Autor: Alessandro Rubini. + :URL: http://www.linuxjournal.com/article.php?sid=1219 + :Fecha: 1996 + :Palabras Clave: device driver, module, loading/unloading modules, + allocating resources, modulos, asignando recursos, módulos kernel cargables. + :Descripción: artículo del Linux Journal Kernel Korner. + :Resumen: *Este es el primero de una serie de cuatro artículos + co-escrito por Alessandro Rubini y Georg Zezchwitz que presentan + un enfoque práctico para escribir drivers de dispositivos Linux + como módulos kernel cargables. Esta entrega presenta una + introducción al tema, preparando al lector para entender la entrega + del próximo mes*. + + * Título: **Dynamic Kernels: Discovery** + + :Autor: Alessandro Rubini. + :URL: http://www.linuxjournal.com/article.php?sid=1220 + :Fecha: 1996 + :Palabras Clave: character driver, init_module, clean_up module, + autodetection, mayor number, minor number, file operations, + open(), close(), dispositivo, driver de caracteres. + :Descripción: artículo del Linux Journal Kernel Korner. + :Resumen: *Este artículo, el segundo de cuatro, introduce parte de + código real para crear un módulo personalizado que implemente un + driver de dispositivo. Describe el código para la inicialización + del módulo y limpieza, así como las llamadas al sistema open() y + close()*. + + * Título: **The Devil's in the Details** + + :Autor: Georg v. Zezschwitz and Alessandro Rubini. + :URL: http://www.linuxjournal.com/article.php?sid=1221 + :Fecha: 1996 + :Palabras Clave: read(), write(), select(), ioctl(), blocking/non + blocking mode, interrupt handler, dispositivo, driver de caracteres. + :Descripción: artículo del Linux Journal Kernel Korner. + :Resumen: *Este artículo, el tercero de cuatro sobre escritura de + drivers de dispositivos de caracteres, introduce conceptos de + lectura, escritura y uso de llamadas ioctl*. + + * Título: **Dissecting Interrupts and Browsing DMA** + + :Autor: Alessandro Rubini and Georg v. Zezschwitz. + :URL: https://www.linuxjournal.com/article.php?sid=1222 + :Fecha: 1996 + :Palabras Clave: interrupciones, irqs, DMA, bottom halves, task queues. + :Descripción: artículo del Linux Journal Kernel Korner. + :Resumen: *Este es el cuarto de una serie de artículos sobre escribir + drivers de dispositivos de caracteres como módulos cargables del + kernel. Este mes, investigamos más a fondo el tema de manejo de + interrupciones. Aunque es conceptualmente simple, las limitaciones + prácticas y las restricciones hacen que esta sea una parte + "interesante" sobre la escritura del driver del dispositivo, y se + han proporcionado varias cuestiones diferentes para diferentes + situaciones. También investigamos el complejo tema de DMA*. + + * Título: **Device Drivers Concluded** + + :Autor: Georg v. Zezschwitz. + :URL: https://www.linuxjournal.com/article.php?sid=1287 + :Fecha: 1996 + :Palabras Clave: address spaces, pages, pagination, page management, + demand loading, swapping, memory protection, memory mapping, mmap, + virtual memory areas (VMAs), vremap, PCI, espacio de direcciones, + gestión de páginas. + :Descripción: Finalmente, lo anterior resultó en una serie de cinco + artículos. La introducción de este último dice: "Este es el último + de cinco artículos sobre drivers de dispositivos de caracteres. En + esta sección final, Georg se ocupa de los dispositivos de mapeo de + memoria, comenzando con una descripción general de los conceptos + de gestión de memoria de Linux". + + * Título: **Network Buffers And Memory Management** + + :Autor: Alan Cox. + :URL: https://www.linuxjournal.com/article.php?sid=1312 + :Fecha: 1996 + :Palabras Clave: sk_buffs, network devices, protocol/link layer + variables, network devices flags, transmit, receive, + configuration, multicast, redes, transmitir, recibir, drivers de red. + :Descripción: Linux Journal Kernel Korner. + :Resumen: *Escribir un driver de dispositivo de red para Linux es + fundamentalmente simple --- la mayor parte de la complejidad + (aparte de hablar con el hardware) implica la gestión de paquetes + de red en la memoria*. + + * Título: **Analysis of the Ext2fs structure** + + :Autor: Louis-Dominique Dubeau. + :URL: https://teaching.csse.uwa.edu.au/units/CITS2002/fs-ext2/ + :Fecha: 1994 + :Palabras Clave: ext2, filesystem, ext2fs, inodos. + :Descripción: Descripción de los bloques, directorios, inodos, + mapas de bits, invariantes... + +Libros publicados +----------------- + + * Título: **Linux Treiber entwickeln** + + :Autor: Jürgen Quade, Eva-Katharina Kunst + :Publica: dpunkt.verlag + :Fecha: Oct 2015 (4th edition) + :Paginas: 688 + :ISBN: 978-3-86490-288-8 + :Note: Alemán. La tercera edición de 2011 es + mucho más barata y todavía (?) bastante actualizada. + + * Título: **Linux Kernel Networking: Implementation and Theory** + + :Autor: Rami Rosen + :Publica: Apress + :Fecha: December 22, 2013 + :Paginas: 648 + :ISBN: 978-1430261964 + + * Título: **Embedded Linux Primer: A practical Real-World Approach, 2nd Edition** + + :Autor: Christopher Hallinan + :Publica: Pearson + :Fecha: November, 2010 + :Paginas: 656 + :ISBN: 978-0137017836 + + * Título: **Linux Kernel Development, 3rd Edition** + + :Autor: Robert Love + :Publica: Addison-Wesley + :Fecha: July, 2010 + :Paginas: 440 + :ISBN: 978-0672329463 + + * Título: **Essential Linux Device Drivers** + + :Autor: Sreekrishnan Venkateswaran + :Published: Prentice Hall + :Fecha: April, 2008 + :Paginas: 744 + :ISBN: 978-0132396554 + +.. _sp_ldd3_published: + + * Título: **Linux Device Drivers, 3rd Edition** + + :Authors: Jonathan Corbet, Alessandro Rubini, and Greg Kroah-Hartman + :Publica: O'Reilly & Associates + :Fecha: 2005 + :Paginas: 636 + :ISBN: 0-596-00590-3 + :Notas: Más información en + http://www.oreilly.com/catalog/linuxdrive3/ + formato PDF, URL: https://lwn.net/Kernel/LDD3/ + + * Título: **Linux Kernel Internals** + + :Autor: Michael Beck + :Publica: Addison-Wesley + :Fecha: 1997 + :ISBN: 0-201-33143-8 (segunda edición) + + * Título: **Programmation Linux 2.0 API systeme et fonctionnement du noyau** + + :Autor: Remy Card, Eric Dumas, Franck Mevel + :Publica: Eyrolles + :Fecha: 1997 + :Paginas: 520 + :ISBN: 2-212-08932-5 + :Notas: French + + * Título: **The Design and Implementation of the 4.4 BSD UNIX Operating System** + + :Autor: Marshall Kirk McKusick, Keith Bostic, Michael J. Karels, + John S. Quarterman + :Publica: Addison-Wesley + :Fecha: 1996 + :ISBN: 0-201-54979-4 + + * Título: **Unix internals -- the new frontiers** + + :Autor: Uresh Vahalia + :Publica: Prentice Hall + :Fecha: 1996 + :Paginas: 600 + :ISBN: 0-13-101908-2 + + * Título: **Programming for the real world - POSIX.4** + + :Autor: Bill O. Gallmeister + :Publica: O'Reilly & Associates, Inc + :Fecha: 1995 + :Paginas: 552 + :ISBN: I-56592-074-0 + :Notas: Aunque no se trata directamente de Linux, Linux pretende ser + POSIX. Buena referencia. + + * Título: **UNIX Systems for Modern Architectures: Symmetric Multiprocessing and Caching for Kernel Programmers** + + :Autor: Curt Schimmel + :Publica: Addison Wesley + :Fecha: June, 1994 + :Paginas: 432 + :ISBN: 0-201-63338-8 + + * Título: **The Design and Implementation of the 4.3 BSD UNIX Operating System** + + :Autor: Samuel J. Leffler, Marshall Kirk McKusick, Michael J + Karels, John S. Quarterman + :Publica: Addison-Wesley + :Fecha: 1989 (reimpreso con correcciones en October, 1990) + :ISBN: 0-201-06196-1 + + * Título: **The Design of the UNIX Operating System** + + :Autor: Maurice J. Bach + :Publica: Prentice Hall + :Fecha: 1986 + :Paginas: 471 + :ISBN: 0-13-201757-1 + +Recursos varios +--------------- + + * Título: **Cross-Referencing Linux** + + :URL: https://elixir.bootlin.com/ + :Palabras Clave: Browsing source code. + :Descripción: Otro navegador de código fuente del kernel Linux que se + encuentra en la web. Muchas referencias cruzadas a variables y + funciones. Puedes ver dónde se definen y dónde se utilizan. + + * Título: **Linux Weekly News** + + :URL: https://lwn.net + :Palabras Clave: latest kernel news, noticias del kernel Linux. + :Descripción: El título lo dice todo (Noticias Semanales de Linux). + Hay una sección fija sobre el kernel, resumiendo el trabajo de sus + desarrolladores, correcciones de errores, nuevas funciones y + versiones, producido durante la semana. Publicado todos los jueves. + + * Título: **The home page of Linux-MM** + + :Autor: The Linux-MM team. + :URL: https://linux-mm.org/ + :Palabras Clave: memory management, Linux-MM, mm patches, TODO, docs, + mailing list, administración de memoria, Linux-MM, parches mm, listas + de correo. + :Descripción: Sitio dedicado al desarrollo de la gestión de memoria + de Linux. Parches relacionados con la memoria, HOWTOs, enlaces, + desarrolladores de mm... ¡Si está interesado en el desarrollo de la + gestión de memoria no te lo pierdas! + + * Título: **Kernel Newbies IRC Channel and Website** + + :URL: https://www.kernelnewbies.org + :Palabras Clave: IRC, newbies, channel, asking doubts, canal, dudas, + novatos, preguntar. + :Descripción: #kernelnewbies en irc.oftc.net. + #kernelnewbies es una red de IRC dedicada al hacker del kernel + 'novato'. La audiencia se compone principalmente de personas que + quieren aprender sobre el kernel, trabajar en proyectos del kernel + o hackers profesionales del kernel que quieren ayudar a la gente + menos experimentada. + #kernelnewbies es parte de la red OFTC IRC. + Pruebe con irc.oftc.net como su servidor y luego haga /join + #kernelnewbies. + El sitio web kernelnewbies también alberga artículos, documentos, FAQs... + + * Título: **linux-kernel mailing list archives and search engines** + + :URL: http://vger.kernel.org/vger-lists.html + :URL: http://www.uwsg.indiana.edu/hypermail/linux/kernel/index.html + :URL: http://groups.google.com/group/mlist.linux.kernel + :Palabras Clave: linux-kernel, archives, buscar, search, archivos. + :Descripción: Algunos de los archivadores de listas de correo del + kernel de Linux. Si usted tiene uno mejor/otro, por favor hágamelo + saber. + +------- + +Este documento se basaba originalmente en: +https://www.dit.upm.es/~jmseyas/linux/kernel/hackers-docs.html