From nobody Mon Oct 9 11:49:26 2023 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4S3y4R32TXz4wHyd; Mon, 9 Oct 2023 11:49:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4S3y4R1h2kz4QSG; Mon, 9 Oct 2023 11:49:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1696852167; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=R8kz+Wt1q7G4Q7zod8UwnhR1GwWaKKMi13c3q2OJANw=; b=se4LCMRJ8vRCv8UymMklxx9T6cQ9VBKHsR1+rRXC1lrSROw5EcacU5WxspOr2h/sAXE2I7 aJbZDi1ZpG3SgSa2bGC6A7ZKlGBabniEk5NxIyN68ide+v8sq3aVPs1aSmVnB9ctk1i7ZY YukkK0DoeHnjVzzgMa+PNwdDWMLw8gTq9B53gNucH8T67gDCocUPYM0AC6+gYKkZ3wnnxa Qe6Qvc1+bFfOeQ+z10W6d9T4YSKHgCXdhX7n5qQEMojrz8nabiAcSVDlYg35FNMdlaUARR 0X/GMsg4MfX5b7ZWYcDxs9OqGaW8yWy0RkHG6BCHz5491T1WVyEOMdiBq2VFxQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1696852167; a=rsa-sha256; cv=none; b=Q9Azahk/fxTPUha5Ec9M4itO6PX3+xyzrZ0sdpIUKpK1MRFpny/3LoUVnBqCEiOPYgvKdg 4L9CYNBi67Yeqr1Bw+vPOVZH2RpgPXuWF4GHGXJaRp3YDcLGu/zcR8yY9xgTT1Qse77+Lr +lYAXAdSpxIVdQ1dBZScusR1JLMVuWVLAIvXTKyeTSSd/O08wziIwCbRjZz8KAhfYu+Kv8 U0ahWJrTe3769ih96iIYEmQcnzyqUHTaqar/tYilW+a8gnhvwQKzsRUIgZAEnNxpNTY1xB +a8I9QfvJ8qajKPwe9HOclMsDS5YxZETsClijOIZD5alT+0iOHTw9PA/tre7MA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1696852167; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=R8kz+Wt1q7G4Q7zod8UwnhR1GwWaKKMi13c3q2OJANw=; b=slXrd7POcNalBdR/fIsVGKitOC0vh5mV0A8QklcbRYgInTEwNDdj7Ip/iNOygwC7ofaZ+v /pocVow1zHSEgMhiuQjvFsoXQCCae7yL69X5aIBhihUb96RgcA+tkHAT7Bf5zziPLVW/A9 SXmBzcxqsVgE5Eu1zQCDGX+vetxDx25XrWYxQROPJpKiozGXHb+mLKlMgUj/PlWDzPFMvY 0VoawKxwMpUK4H6mLIREoo+fTcd664k5fWD1mrL3MOhIIC0ZntOIPSyFywq794B/p45dM1 OqQ2Yj1i3EsJHv4FR57FOdtxq5qdTf8AJrVQv0+AtSC5xdckHnOqRyBpbDdUpQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4S3y4R0Vx4zv4S; Mon, 9 Oct 2023 11:49:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 399BnQGr024002; Mon, 9 Oct 2023 11:49:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 399BnQo0023999; Mon, 9 Oct 2023 11:49:26 GMT (envelope-from git) Date: Mon, 9 Oct 2023 11:49:26 GMT Message-Id: <202310091149.399BnQo0023999@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Eugene Grosbein Subject: git: 3523f0677ef5 - main - fdc.4: document fdc sysctls List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: eugen X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3523f0677ef514fe72710033c73cc58517b9cda8 Auto-Submitted: auto-generated The branch main has been updated by eugen: URL: https://cgit.FreeBSD.org/src/commit/?id=3523f0677ef514fe72710033c73cc58517b9cda8 commit 3523f0677ef514fe72710033c73cc58517b9cda8 Author: Felix Johnson AuthorDate: 2023-10-09 11:46:03 +0000 Commit: Eugene Grosbein CommitDate: 2023-10-09 11:48:52 +0000 fdc.4: document fdc sysctls PR: 105608 MFC-after: 1 week --- share/man/man4/fdc.4 | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 56 insertions(+), 1 deletion(-) diff --git a/share/man/man4/fdc.4 b/share/man/man4/fdc.4 index f42a74b3a65c..929baf3a234b 100644 --- a/share/man/man4/fdc.4 +++ b/share/man/man4/fdc.4 @@ -25,7 +25,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd April 7, 2017 +.Dd October 10, 2023 .Dt FDC 4 .Os .Sh NAME @@ -311,6 +311,61 @@ Third argument is a pointer to This type is the same as being used in the per-drive configuration flags, or in the CMOS configuration data or ACPI namespace on IA32 systems. .El +.Sh SYSCTL VARIABLES +.Bl -tag -width "debug.fdc.debugflags" +.It Dv debug.fdc.debugflags +Selectively enable debugging by setting one or more flags. +.Bl -tag -width "0x40" +.It Dv 0x01 +Dump device registers on reset. +.It Dv 0x02 +When an IO operation completes, print the number of retries +when that number is greater than zero. +.It Dv 0x04 +Print when the number of retries exceeds +.Dv debug.fdc.retries +.Pq Dv EIO . +Print when the option +.Dv FDOPT_NOERROR +is set and an error would have returned from a write operation. +.It Dv 0x08 +Print detailed IO command information. +.It Dv 0x10 +Print status registers. +.It Dv 0x20 +Print detailed status registers when interrupts complete. +Print the source code line number close to the source of a +non-zero return from a thread worker operation. +.It Dv 0x40 +Print when the disk appears to be lost. +Print cylinder, head, sector, and sector shift information +after a request to read an ID field. +Notify whether a disk probe resulted in finding a disk. +When detecting the density of media present, indicate whether +the autosensing was successful, and if so, the size of the +medium in kilobytes. +Print detailed type information when setting the drive type. +.It Dv 0x80 +Print when an unknown IOCTL is used. +.El +.It Dv debug.fdc.fifo +For enhanced controllers, allows a non-default FIFO +threshold setting. The default is 8 bytes. +.It Dv debug.fdc.retries +Maximum number of retries to attempt. The default is 10. +.It Dv debug.fdc.spec1 +Specification byte one (step-rate + head unload). +The default step rate is 6 ms. The default head unload +time is 240 ms. +.It Dv debug.fdc.spec2 +Specification byte two (head load time + no-dma). +The default head load time is 16 ms, and no-dma is 0 +.Pq disabled . +.It Dv debug.fdc.settle +Head settling time in +.Sy settle +/ hz seconds. The default value is set during device attach. +.El .Sh FILES .Bl -tag -width ".Pa /dev/fd*" -compact .It Pa /dev/fd*