Commit Graph

12959 Commits

Author SHA1 Message Date
Ceri Davies
620b5bfaef rc.conf.5: document name_cpuset, introduced in rev 0661f93892 2023-05-11 22:06:56 +01:00
Mitchell Horne
031049cf32 hier(7): fix a couple mandoc warnings
These references are rendered correctly without the zero-width space.

MFC after:	1 week
Sponsored by:	The FreeBSD Foundation
2023-05-10 10:26:35 -03:00
Mitchell Horne
36db6b0496 hier(7): document /home/ and /usr/home/
Reviewed by:	imp
MFC after:	1 week
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D40002
2023-05-10 10:25:17 -03:00
Mitchell Horne
1bc55f5839 hier(7): drop list of /usr/share/doc subdirectories
Several entries are outdated, several new ones are missing. I do not
think there is much value added in maintaining this.

Reviewed by:	imp, emaste
MFC after:	1 week
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D40001
2023-05-10 10:18:21 -03:00
Mitchell Horne
c3b611e153 hier(7): drop list of /usr/include subdirectories
It is nice to have, however, the location of this information means that
it will naturally be missed by developers adding or removing directories
to the layout, so it trends out-of-date and it is out-of-date.

The target audience for hier(7) is users and administrators. It is not
expected to be a place that programmers should go to learn about the
purposes of the different C headers provided by FreeBSD.

Program authors needing FreeBSD-specific interfaces or libraries
(#include <sys/queue.h>, for instance) will either be following a more
detailed man page, or consulting the header contents directly. Folks
targeting standardized headers (#include <sys/time.h>) will not need
hier(7) to tell them where those headers are under /usr/include.

In other words, this is more detail than necessary for this document.
I'd go as far as to say that many of the existing entries in this list
do little more than parrot the name of the directory.

With all this in mind, let's drop the maintenance burden.

Reviewed by:	imp, emaste
MFC after:	1 week
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D40000
2023-05-10 10:17:41 -03:00
Yuri Pankov
b0cf48305f em(4): update sysctl list, mention iflib(4)
Some of the settings, e.g. disabling/enabling msix, are now handled
as generic iflib variables; mention iflib explicitly in tunables
section (in addition to SEE ALSO).

Reviewed by:	cc, gbe (manpages)
Differential Revision:	https://reviews.freebsd.org/D39999
2023-05-09 10:00:32 +02:00
Yuri Pankov
1e37655ec3 vt(4): document enable_altgr
Reviewed by:	bcr
Differential Revision:	https://reviews.freebsd.org/D39997
2023-05-08 15:51:43 +02:00
Warner Losh
f710a4de92 twe: Add deprecation notice
This was flagged for removal in 14 over a year ago. Add deprecation to
man page.

MFC After: 3 days
2023-05-07 23:14:12 -06:00
Joseph Koshy
c2eae5c39a
man9: Add a manual page for kstack_contains(9).
Approved by:	gnn (mentor)
Reviewed by:	mhorne
Differential Revision: https://reviews.freebsd.org/D39933
2023-05-05 15:42:59 +01:00
Ed Maste
fa4651d7ea build.7: remove reference to deprecated mergemaster
Sponsored by:	The FreeBSD Foundation
2023-05-04 21:14:06 -04:00
Warner Losh
a1bae244b6 Add wifi(4) alias for wlan(4).
Suggested by:		jrtc27
Sponsored by:		Netflix
2023-05-04 16:20:56 -06:00
Tom Hukins
560a7d2584 mpr(4) & mps(4): refer to related utilities
Reviewed by: imp
Pull Request: https://github.com/freebsd/freebsd-src/pull/729
2023-05-04 16:06:27 -06:00
Tom Hukins
8fb0f07c7a wlan(4): Mention WiFi more prominently
WiFi is a commonly used term to describe wireless LANs.  Adding this
word will help readers better understand the contents of this manual
page and will help find the page when searching, for example when
running `man -k wifi`.

Pull Request: https://github.com/freebsd/freebsd-src/pull/721
Reviewed by: imp
2023-05-04 15:59:12 -06:00
Ed Maste
83d5725005 src.conf.5: regen after MK_TOOLCHAIN / MK_INCLUDES decoupling 2023-05-01 20:39:30 -04:00
Tom Hukins
e5bc2547a5 geom(4): Add cross reference to geom(8)
PR:		264387
Reviewed by:	ceri
Pull Request:	https://github.com/freebsd/freebsd-src/pull/702
2023-05-01 11:06:00 -04:00
Tom Hukins
865362061d mfi(4): Refer to mrsas(4)
Reviewed by:	imp
Pull Request:	https://github.com/freebsd/freebsd-src/pull/722
2023-05-01 11:06:00 -04:00
Tom Hukins
a58648a68b wlan(4): Add more related drivers to "See also"
Pull Request:	https://github.com/freebsd/freebsd-src/pull/721
2023-05-01 10:38:09 -04:00
Ed Maste
e3b937fa9e src.conf.5: regen after 4f6a5e1d6c, NETLINK_SUPPORT default change
Sponsored by:	The FreeBSD Foundation
2023-04-28 14:15:07 -04:00
Ravi Pokala
de57e0ef5a jedec_dimm(4): Add manufacturing year and week.
DDR3 and DDR4 encode the week and year that the DIMM was manufactured,
as a pair of two-digit binary-coded decimal values. Read the values, and
report them as (uint8_t)s.

Reviewed by:	imp, jhb
MFC after:	1 week
Sponsored by:	Panasas
Differential Revision:	https://reviews.freebsd.org/D39795
2023-04-28 10:53:55 -07:00
Cheng Cui
60167184ab
siftr: remove barely used hash generation per record
Reviewers: rscheff, tuexen
Approved by: rscheff, tuexen
Subscribers: imp, melifaro, glebius
Differential Revision: https://reviews.freebsd.org/D39835
2023-04-26 15:57:42 -04:00
Christian McDonald
ef661d4a5b pf: introduce ridentifier and labels to ether rules
Make Ethernet rules more similar to the usual layer 3 rules by also
allowing ridentifier and labels to be set on them.

Reviewed by:	kp
Sponsored by:	Rubicon Communications, LLC ("Netgate")
2023-04-26 11:14:41 +02:00
Cheng Cui
d090464ecd
Change the unit of srtt and rto to usec, inspired by these in struct "tcp_info". Therefore, no need hz and tcp_rtt_scale in the headline of the log. Update the man page as well.
Summary: Simplify srtt and rto values in siftr log.

Test Plan:
Tested in Emulab testbed:
cc@s1:~ % sudo sysctl net.inet.siftr
net.inet.siftr.port_filter: 0
net.inet.siftr.genhashes: 0
net.inet.siftr.ppl: 1
net.inet.siftr.logfile: /var/log/siftr.log
net.inet.siftr.enabled: 0
cc@s1:~ % sudo sysctl net.inet.siftr.port_filter=5001
net.inet.siftr.port_filter: 0 -> 5001
cc@s1:~ % sudo sysctl net.inet.siftr.enabled=1
net.inet.siftr.enabled: 0 -> 1
cc@s1:~ %
cc@s1:~ % iperf -c r1 -n 1M
------------------------------------------------------------
Client connecting to r1, TCP port 5001
TCP window size: 32.0 KByte (default)
------------------------------------------------------------
[  1] local 10.1.1.2 port 33817 connected with 10.1.1.3 port 5001
[ ID] Interval       Transfer     Bandwidth
[  1] 0.00-0.91 sec  1.00 MBytes  9.22 Mbits/sec
cc@s1:~ % sudo sysctl net.inet.siftr.enabled=0
net.inet.siftr.enabled: 1 -> 0

cc@s1:~ % ll /var/log/siftr.log
-rw-r--r--  1 root  wheel    91K Apr 25 09:38 /var/log/siftr.log
cc@s1:~ % cat /var/log/siftr.log
enable_time_secs=1682437111	enable_time_usecs=121115	siftrver=1.3.0	sysname=FreeBSD	sysver=1400088	ipmode=4
o,0x00000000,1682437125.907343,10.1.1.2,33817,10.1.1.3,5001,1073725440,1073725440,2,0,0,0,0,2,536,0,1,672,1000000,32768,0,65536,0,0,0,0,0
i,0x00000000,1682437126.106759,10.1.1.2,33817,10.1.1.3,5001,1073725440,1073725440,2,0,0,0,0,2,536,0,1,672,1000000,32768,0,65536,0,1,0,0,0
o,0x00000000,1682437126.106767,10.1.1.2,33817,10.1.1.3,5001,1073725440,14480,2,65535,65700,9,9,4,1460,201000,1,16778209,803000,33580,0,65700,0,0,0,0,0
o,0x00000000,1682437126.107141,10.1.1.2,33817,10.1.1.3,5001,1073725440,14480,2,65535,65700,9,9,4,1460,201000,1,16778208,803000,33580,60,65700,0,0,0,0,0
...
i,0x00000000,1682437127.016754,10.1.1.2,33817,10.1.1.3,5001,1073725440,606109,1030,748544,66048,9,9,9,1460,100812,1,1008,303000,475948,0,65700,0,0,0,0,0
o,0x00000000,1682437127.016759,10.1.1.2,33817,10.1.1.3,5001,1073725440,606109,1030,748544,66048,9,9,10,1460,100812,1,1011,303000,475948,0,65700,0,0,0,0,0
disable_time_secs=1682437131	disable_time_usecs=767582	num_inbound_tcp_pkts=371	num_outbound_tcp_pkts=186	total_tcp_pkts=557	num_inbound_skipped_pkts_malloc=0	num_outbound_skipped_pkts_malloc=0	num_inbound_skipped_pkts_tcpcb=0	num_outbound_skipped_pkts_tcpcb=0	num_inbound_skipped_pkts_inpcb=0	num_outbound_skipped_pkts_inpcb=0	total_skipped_tcp_pkts=0	flow_list=10.1.1.2;33817-10.1.1.3;5001,

Reviewers: rscheff, tuexen
Approved by: rscheff, tuexen
Subscribers: imp, melifaro, glebius
Differential Revision: https://reviews.freebsd.org/D39803
2023-04-25 13:26:39 -04:00
Mitchell Horne
82bc33d5ad printf(9): clarify the description of %b
The bit values are numbers given in octal representation, not decimal,
as one might assume from the description. Same goes for the base,
although this has an example.

Reviewed by:	emaste
MFC after:	3 days
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D39815
2023-04-25 17:26:36 -03:00
Mateusz Piotrowski
5212225753 cd9660.5: Fix the history section
MFC after:	7 days
Sponsored by:	Klara Inc.
2023-04-25 20:01:21 +02:00
Zhenlei Huang
6f96b5487f elf.5: Fix conjugation of holds
MFC after:	1 week
2023-04-25 18:21:52 +08:00
Cheng Cui
1f782fcc0c
Remove unused fields in siftr_stats. Thus, update the man page as well.
Summary: Remove unused fields in siftr_stats. Thus, update the man page as well.

Test Plan: Tested in Emulab testbed.

Reviewers: rscheff, tuexen
Approved by: rscheff, tuexen
Subscribers: imp, melifaro, glebius
Differential Revision: https://reviews.freebsd.org/D39776
2023-04-24 15:31:15 -04:00
Bjoern A. Zeeb
e51be73a60 ath10k: add man page
Add initial man page for ath10k.4.

MFC after:	2 months
2023-04-23 21:31:08 +00:00
Bjoern A. Zeeb
3c4ba5f554 mt76: add module build framework and man pages
Add framework to build if_mt7915 and if_mt7921 with LinuxKPI
as well as initial man pages for the two mt76 chipset drivers.

MFC after:	2 months
2023-04-23 21:31:07 +00:00
Bjoern A. Zeeb
b95fa4203d man4: fix some mandoc lint for iwlwifi.4 and rtw88.4
Address warnings (but one) from mandoc -T lint for these man pages.

Sponsored by:	The FreeBSD Foundation
MFC after:	3 days
2023-04-23 13:25:24 +00:00
Colin Percival
df53ae0fdd Remove portsnap(8)
Rather than having a tool in the FreeBSD base system for obtaining
the FreeBSD ports tree, users are encouraged to `pkg install git`
and then `git clone https://git.FreeBSD.org/ports.git /usr/ports`.

The portsnap servers will continue operating until FreeBSD 13 reaches
its End-of-Life, and portsnap is available from the ports tree as
ports-mgmt/portsnap.

Requested by:	portmgr
Relnotes:	yes
Differential Revision:	https://reviews.freebsd.org/D39563
X-MFC:		no
2023-04-22 18:12:37 -07:00
Kristof Provost
4bfffd8cf5 pf.conf.5: minor improvements
* Align 'on <interface>' parameter with the BNF, so use 'on <ifspec>'
* Clarify etherprotospec BNF, to make it clearer that only numbers are
  supported.

Suggested by:	Christian McDonald
Sponsored by:	Rubicon Communications, LLC ("Netgate")
2023-04-21 10:08:02 +02:00
Brooks Davis
6c1be0194a src.conf.5: regen with WITH_NETLINK_SUPPORT desc
Reviewed by:	melifaro
Differential Revision:	https://reviews.freebsd.org/D39677
2023-04-20 22:38:36 +01:00
Gordon Bergling
409731e7d7 unionfs.5: Use '.An -nosplit' in the AUTHORS section
Use '.An -nosplit' in the AUTHORS section to prevent line breaks.

MFC after:	3 days
2023-04-19 17:11:41 +02:00
Marius Strobl
a12d60b99e cas.4: Remove remaining sparc64-specific bit
This was missed in 702547720c.
2023-04-18 19:17:24 +02:00
Marius Strobl
8defc88c13 gem(4): Remove onboard-only Sun ERI and remnants of SBus support
These bits are obsolete since 58aa35d429.
This change reverts part of 9ba2b298df as
well as effectively bd3d9826d7, i. e. the
SBus-related modifications. This also gets rid of a nasty hack required
as bus_{read,write}_N(9) doesn't really fit bus_space_subregion(9).
2023-04-18 19:17:24 +02:00
Zhenlei Huang
722b7589cc printf.9: Update the use example of the %D conversion specifier
The output of hexadecimal bytes are in lowercase. Update the example to
reflect the reality.

Reviewed by:	gbe (manpages)
MFC after:	1 week
Differential Revision:	https://reviews.freebsd.org/D39543
2023-04-14 18:08:56 +08:00
Kajetan Staszkiewicz
39282ef356 pf: backport OpenBSD syntax of "scrub" option for "match" and "pass" rules
Introduce the OpenBSD syntax of "scrub" option for "match" and "pass"
rules and the "set reassemble" flag. The patch is backward-compatible,
pf.conf can be still written in FreeBSD-style.

Obtained from:	OpenBSD
MFC after:	never
Sponsored by:	InnoGames GmbH
Differential Revision:	https://reviews.freebsd.org/D38025
2023-04-14 09:04:06 +02:00
John Baldwin
e1ff83fb19 arch.7: Bump Dd after removal of riscv64sf.
Pointy hat to:	jhb
2023-04-12 11:35:33 -07:00
John Baldwin
d27cc06838 src.conf.5: Regen after removal of riscv64sf. 2023-04-12 11:10:37 -07:00
John Baldwin
1ca12bd927 Remove the riscv64sf architecture.
Reviewed by:	jrtc27, arichardson, br, kp, imp, emaste
Differential Revision:	https://reviews.freebsd.org/D39496
2023-04-12 11:09:27 -07:00
Mark Johnston
b4f1582f3b netisr: Purge another reference to NETISR_EPAIR
Fixes:	03276e338a ("netisr: Remove the now-unused NETISR_EPAIR queue index")
MFC after:	1 week
2023-04-12 10:27:00 -04:00
Joseph Koshy
de07f7f06e
procfs: Document the content of /proc/$PID/map.
Approved by:	gnn (mentor)
Differential Revision: https://reviews.freebsd.org/D39484
2023-04-10 16:37:09 +00:00
Mark Johnston
d862b165a6 bridge: Add support for emulated netmap mode
if_bridge receives packets via a special interface, if_bridge_input,
rather than by if_input.  Thus, netmap's usual hooking of ifnet routines
does not work as expected.  Instead, modify bridge_input() to pass
packets directly to netmap when it is enabled.  This applies to both
locally delivered packets and forwarded packets.

When a netmap application transmits a packet by writing it to the host
TX ring, the mbuf chain is passed to if_input, which ordinarily points
to ether_input().  However, when transmitting via if_bridge,
bridge_input() needs to see the packet again in order to decide whether
to deliver or forward.  Thus, introduce a new protocol flag,
M_BRIDGE_INJECT, which 1) causes the packet to be passed to
bridge_input() again after Ethernet processing, and 2) avoids passing
the packet back to netmap.  The source MAC address of the packet is used
to determine the original "receiving" interface.

Reviewed by:	vmaffione
MFC after:	2 months
Sponsored by:	Zenarmor
Sponsored by:	OPNsense
Sponsored by:	Klara, Inc.
Differential Revision:	https://reviews.freebsd.org/D38066
2023-04-10 12:14:11 -04:00
Zhenlei Huang
3fdb40d1be bridge.4: Document the net.link.bridge.log_mac_flap sysctl variable
It was introduced in 2d3614fb13 (bridge: Log MAC address port flapping).

Reviewed by:	gbe (manpages)
MFC after:	2 weeks
Differential Revision:	https://reviews.freebsd.org/D39465
2023-04-10 18:07:04 +08:00
Ed Maste
a9d0665bbb src.conf.5: Expand WITH_LLVM_BINUTILS description
List the specific tools that are controlled by WITH_LLVM_BINUTILS, and
mention the tools that are always or never taken from LLVM.  Tools come
from one of three sources (LLVM, ELF Tool Chain, bespoke base system)
and it is useful to be explicit.

Reviewed by:	markj
Sponsored by:	The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D39428
2023-04-05 13:05:15 -04:00
Ed Maste
96aedfd5c9 src.conf.5: regen for WITHOUT_NETLINK_SUPPORT
Commit 64dfea8651 added a description for WITHOUT_NETLINK_SUPPORT.
2023-04-05 11:39:32 -04:00
Mark Johnston
cab1056105 kdb: Modify securelevel policy
Currently, sysctls which enable KDB in some way are flagged with
CTLFLAG_SECURE, meaning that you can't modify them if securelevel > 0.
This is so that KDB cannot be used to lower a running system's
securelevel, see commit 3d7618d8bf.  However, the newer mac_ddb(4)
restricts DDB operations which could be abused to lower securelevel
while retaining some ability to gather useful debugging information.

To enable the use of KDB (specifically, DDB) on systems with a raised
securelevel, change the KDB sysctl policy: rather than relying on
CTLFLAG_SECURE, add a check of the current securelevel to kdb_trap().
If the securelevel is raised, only pass control to the backend if MAC
specifically grants access; otherwise simply check to see if mac_ddb
vetoes the request, as before.

Add a new secure sysctl, debug.kdb.enter_securelevel, to override this
behaviour.  That is, the sysctl lets one enter a KDB backend even with a
raised securelevel, so long as it is set before the securelevel is
raised.

Reviewed by:	mhorne, stevek
MFC after:	1 month
Sponsored by:	Juniper Networks
Sponsored by:	Klara, Inc.
Differential Revision:	https://reviews.freebsd.org/D37122
2023-03-30 10:45:00 -04:00
Maxim Konovalov
bdb824317b pf.conf.5: typo fixes
PR:	270501 (partially)
2023-03-29 15:34:26 +00:00
Joseph Koshy
6093120776
procfs: Add manual page cross references.
Approved by:	gnn (mentor)
Differential Revision: https://reviews.freebsd.org/D39264
2023-03-25 16:21:34 +00:00
Mark Johnston
40924005c2 kasan.9: Update to note arm64 support 2023-03-23 20:39:10 -04:00