Received: by 2002:a05:6a10:206:0:0:0:0 with SMTP id 6csp199951pxj; Tue, 15 Jun 2021 23:56:17 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwaXIOwQJxCOkKS/31SQ1YT5MNCX467RItUDw/KyyBstBIonztzdxbSrWgprWW7vjMqlJtn X-Received: by 2002:a92:dcc4:: with SMTP id b4mr1803776ilr.183.1623826576852; Tue, 15 Jun 2021 23:56:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1623826576; cv=none; d=google.com; s=arc-20160816; b=qHow9swmTQc3v/uo0O0b2d2eKiAYbHYFmMMJdy7AhZd2LgQOZqjRQZPqqFh9Qx6Jdo VfjVIubvMw045lowJtHC+NyzCMtkv+wJHa7adltgXpZQ9+iQsZP91LUUfmKAdAVhqtsb FmkfFA/S7ZtgV7MPf4bnAAHt+9UQmduGhKKM33qTz1K+138/GqvGmEOKTfhpQvu8sD16 AhU++p8trCu5uk7poWtXnUWUPJkSs7lp8RKRu/RJsCNJsM+iGZOawRvC6DSunZ5fpsSe vih/CEqqCp0M6Cwq4ulY6Hv55gyYtgcqzS3NnFMaO50PuY4Uag/HPv0Piel2zpM2Ky/T Cu8Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=n0VxDryziIsiDsqSnbvHwUeNcPaFJixg3718Khe3JTU=; b=NNSIYqaP2gMv92KXxVClXlKuwKCGwbj9MKPGQwXimSq/v9vorXBx5X3qoNgNx/hwSK nG7zM6ZeQY5U5kfil8EyUzH5GEZU4+4RVz9gsiBHHHI9oo6O3xe2IWq9PqaHxOfyqiqj NOKf8+N6qc/3TDz4nLmWBpWSoBMvf00jls6Au8x9L6SINSz68VK7k70J38lBUZZd5edO 7Vh5fSsHWSX5tRScqnHrG+q3rM5+3/VG4/pXU1OVmCmL5JirRSsLPxFdods5LnLDULuL NeiL05izywMf1pGFJWXT7MV5j4U1mFsoa8YYGSBr+6os54QjlXXIkHmX9RGDgVMztP1G UHcQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=hEHOtITy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id i13si1607429ilm.156.2021.06.15.23.56.04; Tue, 15 Jun 2021 23:56:16 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=hEHOtITy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232055AbhFPG5b (ORCPT + 99 others); Wed, 16 Jun 2021 02:57:31 -0400 Received: from mail.kernel.org ([198.145.29.99]:34614 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231318AbhFPG5X (ORCPT ); Wed, 16 Jun 2021 02:57:23 -0400 Received: by mail.kernel.org (Postfix) with ESMTPSA id 0BDA7613D0; Wed, 16 Jun 2021 06:55:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1623826518; bh=XfaDbhyWTZnv4WQEdwoApJzDRlUwiFS9TASTuCgnwjg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=hEHOtITyS9QTJ13JLBFmSz+a9sy/nYwN50DJSymhVLGJK2RX/o2Pf8BGI8eIpWbrV PRYgoIfgEqsS3NWkRZP7I4fMXBUJIC61CFWQTWZrxNT66wuXT5S6E43+fpHzQC2c7y XyAju6YeXaucYg8dnfNGWS4/BW0WvCghjA1OKuYj+CQRJMLzmpKw9UX6NPixDvzUKP 0+eeRYGK6i/4Pos01dFYCZoQMEMyBM6oDsN9QqAT8Pt0mtzywKWW0fbzsXCyq1fL0U VQcunQfFe3Faf5NMh1C+jjdWh2PdRoXfUKAxjvL7KvMbZ8zuFNtns/GE8Y3Z5cRRp4 EB/7Ej2BgR5Ag== Received: by mail.kernel.org with local (Exim 4.94.2) (envelope-from ) id 1ltPSG-004lCO-BS; Wed, 16 Jun 2021 08:55:16 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org Subject: [PATCH 3/8] docs: driver-api: ioctl.rst: replace some characters Date: Wed, 16 Jun 2021 08:55:09 +0200 Message-Id: X-Mailer: git-send-email 2.31.1 In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The conversion tools used during DocBook/LaTeX/html/Markdown->ReST conversion and some cut-and-pasted text contain some characters that aren't easily reachable on standard keyboards and/or could cause troubles when parsed by the documentation build system. Replace the occurences of the following characters: - U+00a0 (' '): NO-BREAK SPACE as it can cause lines being truncated on PDF output Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/ioctl.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/driver-api/ioctl.rst b/Documentation/driver-api/ioctl.rst index c455db0e1627..5b76e765827d 100644 --- a/Documentation/driver-api/ioctl.rst +++ b/Documentation/driver-api/ioctl.rst @@ -25,9 +25,9 @@ ioctl commands that follow modern conventions: ``_IO``, ``_IOR``, with the correct parameters: _IO/_IOR/_IOW/_IOWR - The macro name specifies how the argument will be used.  It may be a + The macro name specifies how the argument will be used. It may be a pointer to data to be passed into the kernel (_IOW), out of the kernel - (_IOR), or both (_IOWR).  _IO can indicate either commands with no + (_IOR), or both (_IOWR). _IO can indicate either commands with no argument or those passing an integer value instead of a pointer. It is recommended to only use _IO for commands without arguments, and use pointers for passing data. @@ -200,10 +200,10 @@ cause an information leak, which can be used to defeat kernel address space layout randomization (KASLR), helping in an attack. For this reason (and for compat support) it is best to avoid any -implicit padding in data structures.  Where there is implicit padding +implicit padding in data structures. Where there is implicit padding in an existing structure, kernel drivers must be careful to fully initialize an instance of the structure before copying it to user -space.  This is usually done by calling memset() before assigning to +space. This is usually done by calling memset() before assigning to individual members. Subsystem abstractions -- 2.31.1