From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-yb1-f201.google.com (mail-yb1-f201.google.com [209.85.219.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 289FB1E3775 for ; Fri, 1 Nov 2024 21:18:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730495921; cv=none; b=R1dl/fUFZRYW/un2k2LwomLXMScCZm7Knd5D9tP7iOYKapw1LWyvKNh/zCKANfvTaTGxAMmpNuQGotv9ECC0xYHZP2xmr2XdP7Yc1OgRiy+tHV/ngvFPGvfkPiME25IVHu5bgV9sxm4NoStNphDyegfH4u+3GseQQGgmIB/7WjE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730495921; c=relaxed/simple; bh=GZLGwFaeGlBzE/rs3TJH9JgA+VbP5Z9nT/OMYG9FaZ4=; h=Date:Message-Id:Mime-Version:Subject:From:To:Cc:Content-Type; b=YuMOfi4fPhDp7D33MZjsOnVwv7/MP5Kwj0oSIGIY/v/KwnGV+bwjJzn+nwm6Z8k5tbQ7nWKC9jWYYMuAMv72cnNUYEjaTDT7qJfC6JotrL3auOlUhvb4HwEJrUg2wLg585p+NAg9TI5vLtEuCgBhyXesPsuvY9v552vxSythNIc= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--irogers.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=Ngxtxm5P; arc=none smtp.client-ip=209.85.219.201 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--irogers.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="Ngxtxm5P" Received: by mail-yb1-f201.google.com with SMTP id 3f1490d57ef6-e30ba241e7eso4805466276.2 for ; Fri, 01 Nov 2024 14:18:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1730495917; x=1731100717; darn=vger.kernel.org; h=cc:to:from:subject:mime-version:message-id:date:from:to:cc:subject :date:message-id:reply-to; bh=RKAUdhOSS2JqfDDbXfpdKgYJP1GP/t8//+MWRIuse6M=; b=Ngxtxm5PCOCrVv9fyZTNO5J3wZ/1qCiGFEuIYdhWCzcF+frLGRPyH8y91OgCsWme6z +OTMq1NLEzCcZ1GHRyf4vsP7n1vLsf8/b6PAUolh7v49Dvg68R9VkYepcxO+P3dA8YmL Cc5+ay4WsxoLqmyRBtqBYFTPPZAV58BziqPgOpeS2HYnN4E7eJPZqXVqKYioX5WusQ3g kHY7e/TGjC4Cg6V5rSc5PR3OxS9hMmv/kZcMdhO8o5yg+rzjANoupbVOPbyYDaYUzjIg yW/t50p0glRhrfuD9y0WLr7pZnli/vtRJ60V4zhPEKNaXbTrEqknmb00k5eKLdCiMS7D 2fBw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1730495917; x=1731100717; h=cc:to:from:subject:mime-version:message-id:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=RKAUdhOSS2JqfDDbXfpdKgYJP1GP/t8//+MWRIuse6M=; b=Pk607CjIf1OJ1vKHf0SVP4zEXSteGsctlfAhUEFDd7W71DBTBB2fG+WciQqty91Wo3 nLyBrIvxbBeF3f5ulS18J+NF7T5f03IcukwXAlXEcwelGHdXeQKVrgHPJv9lQib4Ccus cXKs2r7LYOiIQtk/iFCI/LXeVvBN6ktM3hkc6FM9oqlxprIc/Uqze/sOV4e6eZ9q7GWm VTWoI1hI+PLh06okc9m8g2G+rUTYRvWS79Gvf0NsDeNJBGaOxZJpgyEHp7qEZigfshrJ Nc7wdL0yFgTmt5gDDZdxS1xtbPbriP7el9x0lvg4mOQuTfW0VpLJv/I0S2JzSNJr+ZiZ ekIg== X-Forwarded-Encrypted: i=1; AJvYcCWVsuRpTQpcarkjf5b5Iu3mXdkz2y7Z/cqHDZ10dkJ6SW0H3XxPlAZYmbo4ek6J8S5le57150ZYNQ0=@vger.kernel.org X-Gm-Message-State: AOJu0YzX7R5rvo13qf2CxgHC1ZLesqdWJWiIdY7PMKMIJ1dfFnqRohx1 OPgllrG6Nuj5xlb26IiQWJFgqOB+wUWQi7RU4RJwsibUxne63z2YS937IN9PUBwR1nI2xQ2Tupq M69lqzQ== X-Google-Smtp-Source: AGHT+IHmvQkUsmaHvVLtx8/JrbsBlfHJP8YWtWyFWTuZIqJiUwu2npKVN3KrokNzcinZhefYCbmDQ5uspY8X X-Received: from irogers.svl.corp.google.com ([2620:15c:2c5:11:f2e6:5ab5:a95f:35cb]) (user=irogers job=sendgmr) by 2002:a25:83c3:0:b0:e30:c79e:16bc with SMTP id 3f1490d57ef6-e30c79e1861mr13963276.8.1730495916629; Fri, 01 Nov 2024 14:18:36 -0700 (PDT) Date: Fri, 1 Nov 2024 14:18:27 -0700 Message-Id: <20241101211830.1298073-1-irogers@google.com> Precedence: bulk X-Mailing-List: linux-man@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 X-Mailer: git-send-email 2.47.0.199.ga7371fff76-goog Subject: [PATCH v4 1/4] proc_pid_fdinfo.5: Reduce indent for most of the page From: Ian Rogers To: Alejandro Colomar , "G . Branden Robinson" Cc: David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Jonathan Corbet , dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-man@vger.kernel.org, Ian Rogers Content-Type: text/plain; charset="UTF-8" When /proc/pid/fdinfo was part of proc.5 man page the indentation made sense. As a standalone man page the indentation doesn't need to be so far over to the right. Remove the initial tagged pragraph, move the "since Linux 2.6.22" to a new history subsection. Suggested-by: G. Branden Robinson Signed-off-by: Ian Rogers --- v4. Move since to history from Alejandro Colomar's review comment. --- man/man5/proc_pid_fdinfo.5 | 51 +++++++++++++++++++------------------- 1 file changed, 25 insertions(+), 26 deletions(-) diff --git a/man/man5/proc_pid_fdinfo.5 b/man/man5/proc_pid_fdinfo.5 index 1e23bbe02..ad739bd84 100644 --- a/man/man5/proc_pid_fdinfo.5 +++ b/man/man5/proc_pid_fdinfo.5 @@ -8,8 +8,6 @@ .SH NAME /proc/pid/fdinfo/ \- information about file descriptors .SH DESCRIPTION -.TP -.IR /proc/ pid /fdinfo/ " (since Linux 2.6.22)" This is a subdirectory containing one entry for each file which the process has open, named by its file descriptor. The files in this directory are readable only by the owner of the process. @@ -17,9 +15,9 @@ The contents of each file can be read to obtain information about the corresponding file descriptor. The content depends on the type of file referred to by the corresponding file descriptor. -.IP +.P For regular files and directories, we see something like: -.IP +.P .in +4n .EX .RB "$" " cat /proc/12015/fdinfo/4" @@ -28,7 +26,7 @@ flags: 01002002 mnt_id: 21 .EE .in -.IP +.P The fields are as follows: .RS .TP @@ -51,7 +49,6 @@ this field incorrectly displayed the setting of at the time the file was opened, rather than the current setting of the close-on-exec flag. .TP -.I .I mnt_id This field, present since Linux 3.15, .\" commit 49d063cb353265c3af701bab215ac438ca7df36d @@ -59,13 +56,13 @@ is the ID of the mount containing this file. See the description of .IR /proc/ pid /mountinfo . .RE -.IP +.P For eventfd file descriptors (see .BR eventfd (2)), we see (since Linux 3.8) .\" commit cbac5542d48127b546a23d816380a7926eee1c25 the following fields: -.IP +.P .in +4n .EX pos: 0 @@ -74,16 +71,16 @@ mnt_id: 10 eventfd\-count: 40 .EE .in -.IP +.P .I eventfd\-count is the current value of the eventfd counter, in hexadecimal. -.IP +.P For epoll file descriptors (see .BR epoll (7)), we see (since Linux 3.8) .\" commit 138d22b58696c506799f8de759804083ff9effae the following fields: -.IP +.P .in +4n .EX pos: 0 @@ -93,7 +90,7 @@ tfd: 9 events: 19 data: 74253d2500000009 tfd: 7 events: 19 data: 74253d2500000007 .EE .in -.IP +.P Each of the lines beginning .I tfd describes one of the file descriptors being monitored via @@ -110,13 +107,13 @@ descriptor. The .I data field is the data value associated with this file descriptor. -.IP +.P For signalfd file descriptors (see .BR signalfd (2)), we see (since Linux 3.8) .\" commit 138d22b58696c506799f8de759804083ff9effae the following fields: -.IP +.P .in +4n .EX pos: 0 @@ -125,7 +122,7 @@ mnt_id: 10 sigmask: 0000000000000006 .EE .in -.IP +.P .I sigmask is the hexadecimal mask of signals that are accepted via this signalfd file descriptor. @@ -135,12 +132,12 @@ and .BR SIGQUIT ; see .BR signal (7).) -.IP +.P For inotify file descriptors (see .BR inotify (7)), we see (since Linux 3.8) the following fields: -.IP +.P .in +4n .EX pos: 0 @@ -150,7 +147,7 @@ inotify wd:2 ino:7ef82a sdev:800001 mask:800afff ignored_mask:0 fhandle\-bytes:8 inotify wd:1 ino:192627 sdev:800001 mask:800afff ignored_mask:0 fhandle\-bytes:8 fhandle\-type:1 f_handle:27261900802dfd73 .EE .in -.IP +.P Each of the lines beginning with "inotify" displays information about one file or directory that is being monitored. The fields in this line are as follows: @@ -168,19 +165,19 @@ The ID of the device where the target file resides (in hexadecimal). .I mask The mask of events being monitored for the target file (in hexadecimal). .RE -.IP +.P If the kernel was built with exportfs support, the path to the target file is exposed as a file handle, via three hexadecimal fields: .IR fhandle\-bytes , .IR fhandle\-type , and .IR f_handle . -.IP +.P For fanotify file descriptors (see .BR fanotify (7)), we see (since Linux 3.8) the following fields: -.IP +.P .in +4n .EX pos: 0 @@ -190,7 +187,7 @@ fanotify flags:0 event\-flags:88002 fanotify ino:19264f sdev:800001 mflags:0 mask:1 ignored_mask:0 fhandle\-bytes:8 fhandle\-type:1 f_handle:4f261900a82dfd73 .EE .in -.IP +.P The fourth line displays information defined when the fanotify group was created via .BR fanotify_init (2): @@ -210,7 +207,7 @@ argument given to .BR fanotify_init (2) (expressed in hexadecimal). .RE -.IP +.P Each additional line shown in the file contains information about one of the marks in the fanotify group. Most of these fields are as for inotify, except: @@ -228,16 +225,16 @@ The events mask for this mark The mask of events that are ignored for this mark (expressed in hexadecimal). .RE -.IP +.P For details on these fields, see .BR fanotify_mark (2). -.IP +.P For timerfd file descriptors (see .BR timerfd (2)), we see (since Linux 3.17) .\" commit af9c4957cf212ad9cf0bee34c95cb11de5426e85 the following fields: -.IP +.P .in +4n .EX pos: 0 @@ -296,5 +293,7 @@ fields contain the values that .BR timerfd_gettime (2) on this file descriptor would return.) .RE +.SH HISTORY +Since Linux 2.6.22. .SH SEE ALSO .BR proc (5) -- 2.47.0.199.ga7371fff76-goog