diff --git a/website/content/en/releases/15.1R/_index.adoc b/website/content/en/releases/15.1R/_index.adoc index ff17469ef5..8eb581b52b 100644 --- a/website/content/en/releases/15.1R/_index.adoc +++ b/website/content/en/releases/15.1R/_index.adoc @@ -1,31 +1,31 @@ --- -title: "FreeBSD X.0 Release Information" +title: "FreeBSD 15.1 Release Information" sidenav: download --- -:localRel: X.0 -:localBranchStable: stable/X -:localBranchReleng: releng/X.0 +:localRel: 15.1 +:localBranchStable: stable/15 +:localBranchReleng: releng/15.1 = FreeBSD {localRel} Release Information == Introduction This is the index page for FreeBSD {localRel}. For more information about the release engineering process, please see the link:../../releng/[Release Engineering] section of the web site. == Detailed Information More detailed information //, such as release notes // and hardware notes, can be found at these pages: //link:announce/[FreeBSD {localRel}-RELEASE announcement] + //link:signatures/[FreeBSD {localRel}-RELEASE signed checksum files] + //link:installation/[FreeBSD {localRel}-RELEASE installation information] + //link:hardware/[FreeBSD {localRel}-RELEASE hardware information] + //link:relnotes/[FreeBSD {localRel}-RELEASE release notes] + //link:errata/[FreeBSD {localRel}-RELEASE errata] + //link:readme/[FreeBSD {localRel}-RELEASE readme] + link:schedule/[FreeBSD {localRel}-RELEASE schedule] diff --git a/website/content/en/releases/15.1R/errata.adoc b/website/content/en/releases/15.1R/errata.adoc index a5a5b58526..0a24c5bf52 100644 --- a/website/content/en/releases/15.1R/errata.adoc +++ b/website/content/en/releases/15.1R/errata.adoc @@ -1,71 +1,71 @@ --- -title: "FreeBSD X.0-RELEASE Errata" +title: "FreeBSD 15.1-RELEASE Errata" sidenav: download --- -:release: X.0-RELEASE -:releaseNext: X.1-RELEASE -:releaseBranch: X-STABLE +:release: 15.1-RELEASE +:releaseNext: 15.2-RELEASE +:releaseBranch: 15-STABLE = FreeBSD {release} Errata == Abstract This document lists errata items for FreeBSD {release}, containing significant information discovered after the release or too late in the release cycle to be otherwise included in the release documentation. This information includes security advisories, as well as news relating to the software or documentation that could affect its operation or usability. An up-to-date version of this document should always be consulted before installing this version of FreeBSD. This errata document for FreeBSD {release} will be maintained until the release of FreeBSD {releaseNext}. == Table of Contents * <> * <> * <> * <> * <> [[intro]] == Introduction This errata document contains "late-breaking news" about FreeBSD {release}. Before installing this version, it is important to consult this document to learn about any post-release discoveries or problems that may already have been found and fixed. Any version of this errata document actually distributed with the release (for example, on a CDROM distribution) will be out of date by definition, but other copies are kept updated on the Internet and should be consulted as the "current errata" for this release. These other copies of the errata are located at https://www.FreeBSD.org/releases/, plus any sites which keep up-to-date mirrors of this location. Source and binary snapshots of FreeBSD {releaseBranch} also contain up-to-date copies of this document (as of the time of the snapshot). For a list of all FreeBSD CERT security advisories, see https://www.FreeBSD.org/security/. [[security]] == Security Advisories [width="100%",cols="40%,30%,30%",options="header",] |=== |Advisory |Date |Topic |No advisories.|| |=== [[errata]] == Errata Notices [width="100%",cols="40%,30%,30%",options="header",] |=== |Errata |Date |Topic |No errata notices.|| |=== [[open-issues]] == Open Issues No open issues. [[late-news]] == Late-Breaking News No late-breaking news. diff --git a/website/content/en/releases/15.1R/hardware.adoc b/website/content/en/releases/15.1R/hardware.adoc index f98b4c0c2d..da3c935ca5 100644 --- a/website/content/en/releases/15.1R/hardware.adoc +++ b/website/content/en/releases/15.1R/hardware.adoc @@ -1,861 +1,861 @@ --- -title: FreeBSD X.0 Hardware Notes +title: FreeBSD 15.1 Hardware Notes sidenav: download --- :localRel: X.Y :doctype: article :toc: macro :toclevels: 2 :icons: font :sectnums: :source-highlighter: rouge :experimental: = FreeBSD {localRel} Hardware Notes toc::[] [[intro]] == Introduction This hardware compatibility note describes all hardware known to work with FreeBSD {localRel}. Other configurations may also work, but simply have not been tested yet. Feedback, updates, and corrections to this list are encouraged! [[proc]] == Supported Platforms This section describes the CPU architectures currently supported by the FreeBSD Platform projects, their support tiers, and the systems that are supported by each Platform. [[proc-amd64]] === x86-64 crossref:platforms[amd64,FreeBSD/amd64] supports x86-64 as a fully-supported, crossref:committers-guide[archs,Tier-1] architecture. Release media is expected to work on all x86-64 machines with at least 256 MiB of RAM. This release incorporates optimizations and enhancements to leverage the full capabilities of FreeBSD/amd64-based systems, delivering improved performance across a wide range of workloads. [[proc-arm-64]] === AArch64 crossref:platforms[arm64,FreeBSD/aarch64] supports 64-bit ARM (ARMv9 and ARMv8) as a crossref:committers-guide[archs,Tier-1] architecture. The following devices are currently supported: Ampere Computing: * Altra Max * Altra * eMAG link:https://wiki.freebsd.org/arm/Allwinner[Allwinner]: * Allwinner A64 SoC * A64-Olinuxino * Orange Pi PC2 * Pine A64 * Pine A64+ * Pine A64+ 2GB * Pine A64-LTS * SOPINE * NanoPi A64 * OrangePi PC2 * NanoPI K1 Plus * Pine H64 * Orange Pi 3 LTS AWS / Annapurna Labs: * Graviton * Graviton 2 * Graviton 3 Cavium: * ThunderX NXP Semiconductors: * LS1028A SoC * LS1046A SoC * LS1088A SoC * LX2160A SoC * Conclusive Engineering WHLE-LS1 * SolidRun HoneyComb LX2 * Traverse Technologies Ten64 link:https://wiki.freebsd.org/arm/Raspberry%20Pi[Raspberry Pi]: * Raspberry Pi Zero 2 W * Raspberry Pi 3 * Raspberry Pi 4 link:https://wiki.freebsd.org/arm/RockChip[RockChip]: * RK3328 SoC * RK3399 SoC * RK3566 SoC * RK3568 SoC * NanoPC-T4 * NanoPi R2S * NanoPi R2S-Plus * NanoPi R4S * Radxa * Pinebook Pro * Rock64 * RockPro64 Zedboard: * Zynq 7000 SoC [[proc-arm-32]] === AArch32 crossref:platforms[armv7,FreeBSD/armv7] supports 32-bit ARM (ARM-v7 and up) as a crossref:committers-guide[archs,Tier-2] architecture. The following devices are currently supported: link:https://wiki.freebsd.org/arm/Allwinner[Allwinner]: * Allwinner A10 SoC * Allwinner A13/R8 SoC * Allwinner A20 SoC * Allwinner A31 & A31s SoC * Allwinner A83T SoC * Allwinner H3 & H2+ SoC * Allwinner H5 SoC * Allwinner H6 SoC * Cubieboard * A10-OlinuXino-Lime * A13-OLinuXino * Banana Pi * CubieBoard 2 * Lamobo R1 * Olimex A20 SOM * PCDuino3 * BananaPi M3 * Orange Pi +2E * OrangePi One * Orange Pi One Lite * Orange Pi PC * Orange Pi Zero * NanoPI NEO link:https://wiki.freebsd.org/arm/imx6[NXP i.MX6]: * Wandboard * CuBox i * HummingBoard link:https://wiki.freebsd.org/arm/Raspberry%20Pi[Raspberry Pi]: * Raspberry Pi 2 (pre v1.2) [[proc-powerpc]] === POWER FreeBSD supports 64-bit POWER as a crossref:committers-guide[archs,Tier-2] architecture. crossref:platforms[powerpc,FreeBSD/powerpc64le] supports 64-bit, bi-endian POWER9 and POWER8, including: IBM: * Power System LC922 (POWER9) * Power System IC922 (POWER8) QEMU * PowerNV Raptor CS: * Talos II (POWER9) * Blackbird (POWER9) crossref:platforms[powerpc,FreeBSD/powerpc64] supports 64-bit, big-endian POWER9 through POWER4, including the above as well as: A-EON: * AmigaONE X5000 (NXP QorIQ P5) Apple: * Power Mac G5 (PowerPC 970) * Xserve G5 (PowerPC 970) IBM: * pSeries VM [[proc-risc-v]] === RISC-V link:https://wiki.freebsd.org/riscv[FreeBSD/riscv64] supports 64-bit RISC-V as a crossref:committers-guide[archs,Tier-2] architecture. RISC-V support represents a significant milestone in the evolution of this open-source operating system. FreeBSD was the first operating system to have bootable in-tree support for RISC-V, underscoring its commitment to embracing emerging hardware architectures. FreeBSD currently supports the following platforms: * HiFive Unleashed (SiFive FU540) * HiFive Unmatched (SiFive FU740) * StarFive VisionFive 2 (StarFive JH7110) * Spike * QEMU // The "Supported Devices" section of the release notes. // Generally processor-independent, with conditional text // inclusion handling any architecture-dependent text. // Within each subsection describing a class of hardware // (i.e. Ethernet interfaces), list broad groups of devices // alphabetically as paragraphs sorted alphabetically (frequently // these groups will be arranged by manufacturer, i.e. 3Com // Ethernet interfaces). // Where applicable, a "Miscellaneous" section may follow all // other named sections. // These guidelines are not hard-and-fast rules, and exceptions // will occur. Following these guidelines (vague as they may be) // is highly recommended to try to keep the formatting of // this section consistent. // We give manpage references using the &man entities where // possible. If a driver has no manpage (and consequently no // &man entity, we simply give the name of the driver). // Please avoid doing &man entity conversions unless you // know for sure that an entity and manpage exist; sweeps through // this file to fix "missed" conversions are likely to break the // build. [[support]] == Supported Devices This section describes the devices currently known to be supported by each device driver in FreeBSD. If the driver in question has a manual page in the FreeBSD base distribution (most should), it is referenced here. Information on usage, configuration, and specific models of supported devices, controllers, etc. can be found in the manual pages. [NOTE] ==== The device lists in this document are being generated automatically from FreeBSD manual pages. This means that some devices, which are supported by multiple drivers, may appear multiple times. ==== [[disk]] === Disk Controllers &hwlist.aac; &hwlist.aacraid; &hwlist.ahc; &hwlist.ahci; &hwlist.ahd; &hwlist.arcmsr; &hwlist.ata; &hwlist.ciss; [NOTE] ==== [amd64, i386] Booting from these controllers is supported. EISA adapters are not supported. ==== &hwlist.hpt27xx; &hwlist.hptiop; &hwlist.hptmv; &hwlist.hptnr; &hwlist.hptrr; &hwlist.ida; &hwlist.ips; &hwlist.isci; &hwlist.isp; &hwlist.mfi; &hwlist.mlx; [NOTE] ==== [amd64, i386] Booting from these controllers is supported. EISA adapters are not supported. ==== &hwlist.mmcsd; &hwlist.mpi3mr; &hwlist.mpr; &hwlist.mps; &hwlist.mpt; &hwlist.mrsas; &hwlist.mvs; &hwlist.nda; &hwlist.nvd; &hwlist.ocs_fc; &hwlist.pms; &hwlist.pst; &hwlist.sdhci; &hwlist.siis; &hwlist.smartpqi; &hwlist.sym; &hwlist.tws; &hwlist.ufshci; With all supported SCSI controllers, full support is provided for SCSI-I, SCSI-II, and SCSI-III peripherals, including hard disks, optical disks, tape drives (including DAT, 8mm Exabyte, Mammoth, and DLT), medium changers, processor target devices and CD-ROM drives. WORM devices that support CD-ROM commands are supported for read-only access by the CD-ROM drivers (such as man:cd[4]). WORM/CD-R/CD-RW writing support is provided by man:cdrecord[1], which is a part of the package:sysutils/cdrtools[] port in the Ports Collection. The following CD-ROM type systems are supported at this time: * SCSI interface (also includes ProAudio Spectrum and SoundBlaster SCSI) (man:cd[4]) * ATAPI IDE interface (man:acd[4]) [[ethernet]] === Ethernet Interfaces &hwlist.ae; &hwlist.age; &hwlist.alc; &hwlist.ale; &hwlist.aue; &hwlist.axe; &hwlist.axge; &hwlist.bce; The man:bfe[4] driver supports Broadcom BCM4401-based Fast Ethernet devices. &hwlist.bge; &hwlist.bnxt; &hwlist.bxe; &hwlist.cas; &hwlist.cdce; &hwlist.cue; &hwlist.cxgb; &hwlist.cxgbe; &hwlist.cxgbev; &hwlist.dc; &hwlist.man4.powerpc/dtsec; &hwlist.em; The man:ena[4] driver supports the AWS EC2 Elastic Network Adapter. &hwlist.enic; &hwlist.man4.i386/ep; &hwlist.et; &hwlist.man4.i386/ex; &hwlist.man4.i386/fe; &hwlist.fxp; &hwlist.gem; &hwlist.genet; The man:gve[4] driver supports the Google Cloud Compute Engine (GCE) Virtual NIC (gVNIC). &hwlist.hme; &hwlist.ice; &hwlist.igc; &hwlist.ipheth; &hwlist.ix; &hwlist.ixl; &hwlist.jme; &hwlist.kue; &hwlist.lge; &hwlist.liquidio; &hwlist.mgb; &hwlist.mlx4en; &hwlist.mlx4ib; &hwlist.mlx5en; &hwlist.mlx5ib; &hwlist.mos; &hwlist.msk; &hwlist.muge; &hwlist.mxge; &hwlist.my; &hwlist.nfe; &hwlist.nge; &hwlist.oce; &hwlist.pcn; &hwlist.qlnxe; &hwlist.qlxgb; &hwlist.qlxgbe; &hwlist.qlxge; &hwlist.re; &hwlist.rl; &hwlist.rue; &hwlist.sf; &hwlist.sfxge; &hwlist.sge; &hwlist.sis; &hwlist.sk; &hwlist.smsc; &hwlist.sn; &hwlist.ste; &hwlist.stge; &hwlist.ti; &hwlist.tl; &hwlist.man4.powerpc/tsec; &hwlist.txp; &hwlist.udav; &hwlist.ufoma; &hwlist.uhso; &hwlist.ure; &hwlist.urndis; &hwlist.vge; &hwlist.vr; &hwlist.vte; &hwlist.man4.i386/vx; &hwlist.wb; &hwlist.xe; &hwlist.xl; [[switch]] === Ethernet Switches The man:adm6996fc[4] driver supports the Infineon ADM6996FC Fast Ethernet switch controller. &hwlist.man4.arm/ar40xx; &hwlist.arswitch; &hwlist.e6000sw; &hwlist.e6060sw; The man:felix[4] driver supports the Microsemi VSC9959 Felix Gigabit Ethernet switch controller found in the NXP Layerscape LS1028A SoC. &hwlist.ip17x; The man:ksz8995ma[4] driver supports the Micrel KSZ8995MA/KSZ8995FQ Fast Ethernet switch controller. &hwlist.mtkswitch; The *rtl8366* driver supports the Realtek 8366 Gigabit Ethernet switch controller. The *ukswitch* driver is designed to support potentially unknown Ethernet Switches. [[wlan]] === Wireless Network Interfaces &hwlist.ath; &hwlist.ath_hal; &hwlist.bwi; &hwlist.bwn; &hwlist.ipw; &hwlist.iwi; &hwlist.iwlwifi; &hwlist.iwm; &hwlist.iwn; &hwlist.iwx; &hwlist.malo; Marvell 88W8363 IEEE 802.11n wireless network adapters (man:mwl[4] driver) &hwlist.mtw; &hwlist.otus; &hwlist.ral; &hwlist.rsu; &hwlist.rtw88; &hwlist.rtw89; &hwlist.rtwn_pci; &hwlist.rtwn_usb; &hwlist.rum; &hwlist.run; &hwlist.uath; &hwlist.upgt; &hwlist.ural; &hwlist.urtw; &hwlist.wpi; &hwlist.zyd; [[misc-network]] === Miscellaneous Networks &hwlist.man4.i386/ce; &hwlist.man4.i386/cx; &hwlist.man4.i386/cp; &hwlist.man4.i386/ctau; &hwlist.u3g; &hwlist.umb; [[serial]] === Serial Interfaces &hwlist.uart; &hwlist.scc; &hwlist.puc; &hwlist.uark; &hwlist.ubsa; &hwlist.ubser; &hwlist.uchcom; &hwlist.ucycom; &hwlist.ufintek; &hwlist.uftdi; &hwlist.umcs; &hwlist.umct; &hwlist.umoscom; &hwlist.uplcom; &hwlist.uslcom; &hwlist.uvscom; [[sound]] === Sound Devices &hwlist.snd_als4000; &hwlist.snd_atiixp; &hwlist.snd_cmi; &hwlist.snd_cs4281; &hwlist.snd_csa; &hwlist.snd_emu10k1; &hwlist.snd_emu10kx; &hwlist.snd_envy24; &hwlist.snd_envy24ht; &hwlist.snd_es137x; &hwlist.snd_fm801; &hwlist.snd_hda; &hwlist.snd_hdspe; &hwlist.snd_ich; &hwlist.snd_maestro3; &hwlist.snd_neomagic; &hwlist.snd_solo; &hwlist.snd_spicds; &hwlist.snd_t4dwave; &hwlist.snd_uaudio; &hwlist.snd_via8233; &hwlist.snd_via82c686; &hwlist.snd_vibes; [[usb]] === USB Devices A range of USB peripherals are supported; devices known to work are listed in this section. Owing to the generic nature of most USB devices, with some exceptions any device of a given class will be supported, even if not explicitly listed here. [NOTE] ==== USB Bluetooth adapters can be found in <>. USB human interface devices can be found in <>. USB network interfaces can be found in <> or <>. USB serial interfaces can be found in <>. ==== &hwlist.atp; &hwlist.atopcase; &hwlist.man4.powerpc/abtn; &hwlist.man4.powerpc/akbd; &hwlist.man4.powerpc/ams; The man:ehci[4] driver supports USB 2.0 controllers implementing the Enhanced Host Controller Interface standard. &hwlist.ohci; &hwlist.ugold; &hwlist.uhci; &hwlist.uipaq; &hwlist.umass; &hwlist.urio; &hwlist.umodem; &hwlist.rtsx; &hwlist.ulpt; &hwlist.umct; &hwlist.uvisor; &hwlist.xhci; [[firewire]] === IEEE 1394 (Firewire) Devices &hwlist.fwohci; &hwlist.sbp; [[bluetooth]] === Bluetooth Devices &hwlist.ng_ubt; [[crypto-accel]] === Cryptographic Accelerators The man:aesni[4] driver supports the AES and SHA functions of x86 processors. The man:armv8crypto[4] driver supports the AES, SHA-1, SHA-2, and finite field Arithmetic engines in processors implementing the ARMv8 Cryptograpic Extension. The **ccp** driver supports the AMD Platform Security Processor (PSP) Cryptographic Coprocessor found in AMD Ryzen devices. &hwlist.ccr; The man:glxsb[4] driver supports the security block found in AMD Geode LX devices. &hwlist.hifn; The man:padlock[4] driver supports the AES/RNG/RSA/SHA-1, and SHA-2 engine found on Via Technologies C7, C3, and Eden devices. &hwlist.qat; The man:qat_c2xxx[4] driver supports the Intel QuickAssist Technology engine found on Atom C2000 devices. &hwlist.safe; &hwlist.safexcel; [[misc]] === Miscellaneous Keyboards including: * HID keyboards (man:hkbd[4] driver) over USB, I2C, or Apple SPI * USB keyboards (man:ukbd[4] driver) * PS/2 keyboards (man:atkbd[4] driver) * ADB keyboards (man:akbd[4] driver) * AT-style keyboards (man:atkbd[4] driver) * Hyper-v keyboards (**hv_kbd** driver) Pointing devices including: * HID mice (man:hms[4] driver) and touch devices (man:hmt[4] driver) over USB, I2C, Hyper-V, or Apple SPI * USB mice (man:ums[4] driver) and touch devices (man:wmt[4] driver) * Apple laptop trackpads (man:wsp[4] or man:apt[4] drivers) * Elantech I2C touchpads (man:ietp[4] driver) * Chromebook Cypress APA I2C touchpads (man:cyapa[4] driver) * PS/2 mice and compatible devices, including many laptop pointing devices (man:psm[4] driver) * ADB mice and touch devices (man:ams[4] driver) * Serial mice and compatible devices [NOTE] ==== man:moused[8] has more information on using traditional pointing devices with the FreeBSD console. ==== &hwlist.hgame; [amd64, i386] Floppy drives (man:fdc[4] driver) [amd64, i386] VGA-compatible video cards (man:vga[4] driver) [NOTE] ==== Information regarding specific video cards and compatibility with Xorg can be found at link:http://www.x.org/[http://www.x.org/]. ==== [amd64, i386] "PC standard" parallel ports (man:ppc[4] driver) &hwlist.ads111x; &hwlist.amdsbwd; &hwlist.at45d; &hwlist.gpioths; &hwlist.ig4; &hwlist.intpm; &hwlist.mx25l; &hwlist.netfpga10g_nf10bmac; &hwlist.ntb_hw_plx; &hwlist.ow_temp; &hwlist.superio; &hwlist.u2f; &hwlist.udl; diff --git a/website/content/en/releases/15.1R/installation.adoc b/website/content/en/releases/15.1R/installation.adoc index c835732bae..23af2071d9 100644 --- a/website/content/en/releases/15.1R/installation.adoc +++ b/website/content/en/releases/15.1R/installation.adoc @@ -1,90 +1,90 @@ --- -title: "FreeBSD X.0-RELEASE Installation Instructions" +title: "FreeBSD 15.1-RELEASE Installation Instructions" sidenav: download --- -:releaseCurrent: X.0-RELEASE -:releasePrev: X.-1-RELEASE -:releasePrevLegacy: X-1.Y-RELEASE -:localRel: X.0 +:releaseCurrent: 15.1-RELEASE +:releasePrev: 15.0-RELEASE +:releasePrevLegacy: 14.4-RELEASE +:localRel: 15.1 include::shared/en/urls.adoc[] = FreeBSD {localRel}-RELEASE Installation Instructions == Abstract This article gives some brief instructions on installing FreeBSD {releaseCurrent} and upgrading the systems running earlier releases. == Table of Contents * <> * <> [[install]] == Installing FreeBSD The link:{handbook}bsdinstall/[Installing FreeBSD] chapter of the FreeBSD Handbook provides more in-depth information about the installation program itself, including a guided walk-through with screenshots. [[upgrade]] == Upgrading FreeBSD If you are upgrading from a previous release of FreeBSD, please read the upgrading section in the link:../relnotes[Release Notes] for notable incompatibilities carefully. [[upgrade-source]] == Upgrading from Source The procedure for doing a source code based update is described in link:{handbook}cutting-edge/#makeworld[Updating FreeBSD from Source]. For Git use the releng/{localRel} branch which will be where any upcoming Security Advisories or Errata Notices will be applied. [[upgrade-binary]] == Upgrading Using "FreeBSD Update" The man:freebsd-update[8] utility supports binary upgrades of amd64, arm64, and i386 systems running earlier FreeBSD releases. Systems running {releasePrevLegacy} or {releasePrev} can upgrade as follows: [.screen] ---- # freebsd-update fetch # freebsd-update install ---- Now the man:freebsd-update[8] utility can fetch bits belonging to {releaseCurrent}. During this process man:freebsd-update[8] will ask for help in merging configuration files. [.screen,subs="verbatim,attributes"] ---- # freebsd-update upgrade -r {localRel}-RELEASE # freebsd-update install ---- The system must now be rebooted with the newly installed kernel before the non-kernel components are updated. [.screen] ---- # shutdown -r now ---- After rebooting, man:freebsd-update[8] needs to be run again to install the new userland components: [.screen] ---- # freebsd-update install ---- At this point, users of systems being upgraded from earlier FreeBSD releases will be prompted by man:freebsd-update[8] to rebuild or reinstall all third-party applications (e.g., ports installed from the ports tree or packages installed by man:pkg[8]) due to updates in system libraries. After updating installed third-party applications (and again, only if man:freebsd-update[8] printed a message indicating that this was necessary), run man:freebsd-update[8] again so that it can delete the old (no longer used) system libraries: [.screen] ---- # freebsd-update install ---- Finally, reboot into a fully {releaseCurrent} system: [.screen] ---- # shutdown -r now ---- diff --git a/website/content/en/releases/15.1R/readme.adoc b/website/content/en/releases/15.1R/readme.adoc index e252b367e1..8ea02b74ec 100644 --- a/website/content/en/releases/15.1R/readme.adoc +++ b/website/content/en/releases/15.1R/readme.adoc @@ -1,157 +1,157 @@ --- -title: "FreeBSD X.0-RELEASE README" +title: "FreeBSD 15.1-RELEASE README" sidenav: download --- -:releaseCurrent: X.0-RELEASE +:releaseCurrent: 15.1-RELEASE :releaseType: release -:releaseBranch: X-STABLE +:releaseBranch: 15-STABLE :releasePrevStable: X.Y-RELEASE :releasePrev: X.Y-RELEASE include::shared/releases.adoc[] include::shared/en/urls.adoc[] include::shared/en/mailing-lists.adoc[] = FreeBSD {releaseCurrent} README == Abstract This document gives a brief introduction to FreeBSD {releaseCurrent}. It includes some information on how to obtain FreeBSD, a listing of various ways to contact the FreeBSD Project, and pointers to some other sources of information. == Table of Contents * <> * <> * <> * <> * <> [[intro]] == Introduction This distribution is a {releaseType} of FreeBSD {releaseCurrent}, the latest point along the {releaseBranch} branch. [[about]] == About FreeBSD FreeBSD is an open source operating system derived from 4.4 BSD Lite2 for 64-bit x86-based PC hardware (amd64), 32-bit x86-based PC hardware (i386), 64-bit Arm(R) ARMv8-A AArch64 systems (aarch64), 32-bit Arm(R) ARMv6/7 systems (armv6/7), PowerPC(R) systems (powerpc, powerpc64), and RISC-V (riscv64) systems. FreeBSD works with a wide variety of peripherals and configurations and can be used for everything from software development to games to Internet Service Provision. This release of FreeBSD contains everything you need to run such a system, including full source code for the kernel and all utilities in the base distribution. With the source distribution installed, you can literally recompile the entire system from scratch with one command, making it ideal for students, researchers, or users who simply want to see how it all works. A large collection of third-party ported software (the Ports Collection) is also provided to make it easy to obtain and install all your favorite traditional UNIX(R) utilities for FreeBSD. Each port consists of a set of scripts to retrieve, configure, build, and install a piece of software, with a single command. Over {numports} ports, from editors to programming languages to graphical applications, make FreeBSD a powerful and comprehensive operating environment that extends far beyond what's provided by many commercial versions of UNIX(R). Most ports are also available as pre-compiled packages, which can be quickly installed via the {{< manpage "pkg" "8">}} utility. [[audience]] == Target Audience This {releaseType} of FreeBSD is suitable for all users. It has undergone a period of testing and quality assurance to ensure the highest reliability and dependability. [[obtain]] == Obtaining FreeBSD FreeBSD may be obtained in a variety of ways. The most convenient way is to download a release image. Links to images for recent releases can be found on the FreeBSD Web site link:../../../where/[download page]. This page includes information about the different types of images available as well as other ways to obtain a copy of FreeBSD. [[contacting]] == Contacting the FreeBSD Project [[emailmailinglists]] === Email and Mailing Lists For general questions or technical support, please address the {freebsd-questions}. If you track the `{releaseBranch}` branch: you must subscribe to the {freebsd-stable}, to keep abreast of developments and changes that may affect your use and maintainance of the system. Being a largely volunteer effort, the Project is always happy to have extra hands willing to help -- there are far more desired enhancements than there is time to implement them. To contact the developers on technical matters, or with offers of help, please address the {freebsd-hackers}. These lists above can experience significant amounts of traffic. If you have slow or expensive email access, or if you are only interested in major announcements, you may prefer subscription to the {freebsd-announce}. All public mailing lists can be joined by anyone wishing to do so. More than a hundred lists are public; https://lists.freebsd.org/[] shows them all, and provides information about browsing the archives, subscribing, and unsubscribing. [[pr]] === Submitting Problem Reports Suggestions, bug reports and contributions of code are always valued. Please do not hesitate to report any problems you may find. Bug reports with attached fixes are of course even more welcome. The preferred method to submit bug reports from a machine with Internet connectivity is to use the link:https://bugs.freebsd.org[Bugzilla bug tracker]. Problem Reports (PRs) submitted in this way will be filed and their progress tracked; the FreeBSD developers will do their best to respond to all reported bugs as soon as possible. link:https://bugs.freebsd.org/search/[A list of all active PRs] is available on the FreeBSD Web site; this list is useful to see what potential problems other users have encountered. For more information, link:{problem-reports}["Writing FreeBSD Problem Reports"], available on the FreeBSD Web site, has a number of helpful hints on writing and submitting effective problem reports. [[seealso]] == Further Reading There are many sources of information about FreeBSD; some are included with this distribution, while others are available on-line or in print versions. [[release-docs]] === Release Documentation A number of other files provide more specific information about this {releaseType} distribution. These files are provided in various formats. Most distributions will include both ASCII text ([.filename]`.TXT`) and HTML ([.filename]`.HTM`) renditions. Some distributions may also include other formats such as Portable Document Format ([.filename]`.PDF`). * [.filename]`README.TXT`: This file, which gives some general information about FreeBSD as well as some cursory notes about obtaining a distribution. * [.filename]`RELNOTES.TXT`: The release notes, showing what's new and different in FreeBSD {releaseCurrent} compared to the previous release (FreeBSD {releasePrev}). * [.filename]`HARDWARE.TXT`: The hardware compatibility list, showing devices with which FreeBSD has been tested and is known to work. * [.filename]`ERRATA.TXT`: Release errata. Late-breaking, post-release information can be found in this file, which is principally applicable to releases (as opposed to snapshots). It is important to consult this file before installing a release of FreeBSD, as it contains the latest information on problems which have been found and fixed since the release was created. During installation, these documents are available via the Documentation menu. Once the system is installed, you can revisit this menu by re-running the {{< manpage "bsdinstall" "8">}} utility. [.note] *Note*: + To learn about any late-breaking news or post-release problems, it is extremely important to read the errata for any given release before installing it. The errata file accompanying each release (most likely right next to this file) is already out of date by definition, but other copies are kept updated on the Internet and should be consulted as the current errata for this release. These other copies of the errata are located at link:../../releases/[https://www.FreeBSD.org/releases] (as well as any sites which keep up-to-date mirrors of this location). [[manpages]] === Manual Pages As with almost all UNIX(R)-like operating systems, FreeBSD includes a set of manual pages, accessible link:{manual-site}[online] or with the {{< manpage "man" "1">}} command. In general, these pages provide information on the different commands and APIs available to the FreeBSD user. Some pages are written to give information on particular topics. Notable examples include {{< manpage "tuning" "7">}} (a guide to performance tuning), {{< manpage "security" "7">}} (an introduction to FreeBSD security), and {{< manpage "style" "9">}} (a style guide for kernel coding). [[booksarticles]] === Books and Articles FreeBSD Project-maintained documentation includes the highly useful _FreeBSD Handbook_, which includes a detailed guide to installing and upgrading the operating system, and _FreeBSD FAQ_ (Frequently Asked Questions). The link:{handbook}[Handbook] and link:{faq}[FAQ] are online in the link:{main-site}[documentation portal] and at mirror sites. Other Project-maintained books and articles are more specialized -- covering a wide range of topics, from effective use of the mailing lists, to dual-booting FreeBSD with other operating systems, to guidelines for new committers. Like the Handbook and FAQ, these documents are in the portal, mirrors and [.filename]`doc` repository. For offline documentation in HTML and PDF formats: you can install a language-specific package such as package:misc/freebsd-doc-en[] (_-en_ for English), or multi-language package:misc/freebsd-doc-all[]. Alternatively, use a copy of the [.filename]`doc` repo to build and install from source code. A listing of other books and documents about FreeBSD can be found in the link:{handbook}bibliography[bibliography] of the FreeBSD Handbook. Because of FreeBSD's strong UNIX(R) heritage, many other articles and books written for UNIX(R) systems are applicable as well, some of which are also listed in the bibliography. [[acknowledgements]] == Acknowledgments FreeBSD represents the cumulative work of many hundreds, if not thousands, of individuals from around the world who have worked countless hours to bring about this {releaseType}. For a complete list of FreeBSD developers and contributors, please see link:{contributors}["Contributors to FreeBSD"] on the FreeBSD Web site or any of its mirrors. Special thanks also go to the many thousands of FreeBSD users and testers all over the world, without whom this {releaseType} simply would not have been possible. diff --git a/website/content/en/releases/15.1R/relnotes.adoc b/website/content/en/releases/15.1R/relnotes.adoc index 7f79fe8e1d..e49343882a 100644 --- a/website/content/en/releases/15.1R/relnotes.adoc +++ b/website/content/en/releases/15.1R/relnotes.adoc @@ -1,200 +1,200 @@ --- -title: "FreeBSD X.0-RELEASE Release Notes" +title: "FreeBSD 15.1-RELEASE Release Notes" sidenav: download --- -:localRel: X.0 -:releaseCurrent: X.0-RELEASE -:releaseBranch: X-STABLE +:localRel: 15.1 +:releaseCurrent: 15.1-RELEASE +:releaseBranch: 15-STABLE :releasePrev: X.Y-RELEASE :releaseNext: X.Y-RELEASE :releaseType: "release" include::shared/en/urls.adoc[] = FreeBSD {releaseCurrent} Release Notes :doctype: article :toc: macro :toclevels: 1 :icons: font == Abstract [.abstract-title] The release notes for FreeBSD {releaseCurrent} contain a summary of the changes made to the FreeBSD base system on the {releaseBranch} development line. This document lists applicable security advisories that were issued since the last release, as well as significant changes to the FreeBSD kernel and userland. Some brief remarks on upgrading are also presented. [[intro]] == Introduction This document contains the release notes for FreeBSD {releaseCurrent}. It describes recently added, changed, or deleted features of FreeBSD. It also provides some notes on upgrading from previous versions of FreeBSD. The {releaseType} distribution to which these release notes apply represents the latest point along the {releaseBranch} development branch since {releaseBranch} was created. Information regarding pre-built, binary {releaseType} distributions along this branch can be found at https://www.FreeBSD.org/releases/[]. The {releaseType} distribution to which these release notes apply represents a point along the {releaseBranch} development branch between {releasePrev} and the future {releaseNext}. Information regarding pre-built, binary {releaseType} distributions along this branch can be found at https://www.FreeBSD.org/releases/[]. This distribution of FreeBSD {releaseCurrent} is a {releaseType} distribution. It can be found at https://www.FreeBSD.org/releases/[] or any of its mirrors. More information on obtaining this (or other) {releaseType} distributions of FreeBSD can be found in the link:{handbook}/mirrors[Obtaining FreeBSD appendix] to the link:{handbook}/[FreeBSD Handbook]. All users are encouraged to consult the release errata before installing FreeBSD. The errata document is updated with "late-breaking" information discovered late in the release cycle or after the release. Typically, it contains information on known bugs, security advisories, and corrections to documentation. An up-to-date copy of the errata for FreeBSD {releaseCurrent} can be found on the FreeBSD Web site. This document describes the most user-visible new or changed features in FreeBSD since {releasePrev}. In general, changes described here are unique to the {releaseBranch} branch unless specifically marked as MERGED features. Typical release note items document recent security advisories issued after {releasePrev}, new drivers or hardware support, new commands or options, major bug fixes, or contributed software upgrades. They may also list changes to major ports/packages or release engineering practices. Clearly the release notes cannot list every single change made to FreeBSD between releases; this document focuses primarily on security advisories, user-visible changes, and major architectural improvements. [[upgrade]] == Upgrading from Previous Releases of FreeBSD Binary upgrades between RELEASE versions (and snapshots of the various security branches) are supported using the man:freebsd-update[8] utility. See the release-specific upgrade procedure, link:../installation/#upgrade-binary[FreeBSD {releaseCurrent} upgrade information], with more details in the FreeBSD handbook link:{handbook}cutting-edge/#freebsdupdate-upgrade[binary upgrade procedure]. This will update unmodified userland utilities, as well as unmodified GENERIC kernels distributed as a part of an official FreeBSD release. The man:freebsd-update[8] utility requires that the host being upgraded have Internet connectivity. Source-based upgrades (those based on recompiling the FreeBSD base system from source code) from previous versions are supported, according to the instructions in [.filename]#/usr/src/UPDATING#. [IMPORTANT] ==== Upgrading FreeBSD should only be attempted after backing up _all_ data and configuration files. ==== [[security-errata]] == Security and Errata This section lists the various Security Advisories and Errata Notices since {releasePrev}. [[security]] === Security Advisories [.informaltable] [cols="1,1,1", frame="none", options="header"] |=== | Advisory | Date | Topic |No advisories. | | |=== [[errata]] === Errata Notices [.informaltable] [cols="1,1,1", frame="none", options="header"] |=== | Errata | Date | Topic |No notices. | | |=== [[userland]] == Userland This section covers changes and additions to userland applications, contributed software, and system utilities. [[userland-config]] === Userland Configuration Changes [[userland-programs]] === Userland Application Changes [[userland-contrib]] === Contributed Software [[userland-deprecated-programs]] === Deprecated Applications [[userland-libraries]] === Runtime Libraries and API [[kernel]] == Kernel This section covers changes to kernel configurations, system tuning, and system control parameters that are not otherwise categorized. [[kernel-general]] === General Kernel Changes [[drivers]] == Devices and Drivers This section covers changes and additions to devices and device drivers since {releasePrev}. [[drivers-device]] === Device Drivers [[drivers-removals]] === Deprecated and Removed Drivers [[storage]] == Storage This section covers changes and additions to file systems and other storage subsystems, both local and networked. [[storage-general]] === General Storage [[boot]] == Boot Loader Changes This section covers the boot loader, boot menu, and other boot-related changes. [[boot-loader]] === Boot Loader Changes [[network]] == Networking This section describes changes that affect networking in FreeBSD. [[network-general]] === General Network [[hardware]] == Hardware Support This section covers general hardware support for physical machines, hypervisors, and virtualization environments, as well as hardware changes and updates that do not otherwise fit in other sections of this document. Please see link:https://www.freebsd.org/releases/{localRel}R/hardware[the list of hardware] supported by {releaseCurrent}, as well as link:https://www.freebsd.org/platforms/[the platforms page] for the complete list of supported CPU architectures. [[hardware-virtualization]] === Virtualization Support [[documentation]] == Documentation This section covers changes to manual (man:man[1]) pages and other documentation shipped with the base system. [[man-pages]] === Man Pages [[ports]] == Ports Collection and Package Infrastructure This section covers changes to the FreeBSD Ports Collection, package infrastructure, and package maintenance and installation tools. [[ports-packages]] === Packaging Changes [[future-releases]] == General Notes Regarding Future FreeBSD Releases diff --git a/website/content/en/releases/15.1R/schedule.adoc b/website/content/en/releases/15.1R/schedule.adoc index 7b9f0ee41f..0daaf4d06c 100644 --- a/website/content/en/releases/15.1R/schedule.adoc +++ b/website/content/en/releases/15.1R/schedule.adoc @@ -1,64 +1,64 @@ --- -title: "FreeBSD X.0 Release Process" +title: "FreeBSD 15.1 Release Process" sidenav: download --- = FreeBSD {localRel} Release Process -:localRelPrev: X.Y-1 -:localRel: X.0 +:localRelPrev: 15.0 +:localRel: 15.1 :localBranchHead: head -:localBranchStable: stable/X -:localBranchReleng: releng/X.0 +:localBranchStable: stable/15 +:localBranchReleng: releng/15.1 :localMailingList: current include::shared/en/urls.adoc[] == Introduction This is the release schedule for FreeBSD {localRel}. For more information about the release engineering process, please see the link:../../../releng/[Release Engineering] section of the web site. General discussions about the pending release and known issues should be sent to the public mailto:FreeBSD-{localMailingList}@FreeBSD.org[freebsd-{localMailingList}] mailing list. // link:{handbook}glossary/#mfc-glossary[MFC] requests should be sent to link:mailto:re@FreeBSD.org[re@FreeBSD.org] following the link:https://wiki.freebsd.org/Releng/ChangeRequestGuidelines[Change Request Guidelines]. // link:{handbook}glossary/#mfc-glossary[MFC] requests are no longer being accepted for {localBranchReleng}. // link:{handbook}glossary/#mfc-glossary[MFC] requests should be sent to re@FreeBSD.org. == Schedule During the {localBranchHead} freeze, the Release Engineering Team may create ALPHA snapshots to publish for testing purposes. As the frequency and total number of the ALPHA snapshots will depend on the length of time the {localBranchHead} branch is frozen, no official schedule is provided. Announcements regarding the availability of the ALPHA snapshots will be sent to the mailto:freebsd-current@FreeBSD.org[freebsd-current] and mailto:freebsd-snapshots@FreeBSD.org[freebsd-snapshots] mailing lists. [.tblbasic] [cols=",,,",options="header",] |=== |Action |Expected |Actual |Description |Initial release schedule announcement |- |XXX |Release Engineers send announcement email to developers with a rough schedule. |Release schedule reminder |XXX |- |Release Engineers send reminder announcement e-mail to developers with updated schedule. |Code slush begins |XXX |- |Release Engineers announce that all further commits to the {localBranchStable} branch will not require explicit approval, however new features should be avoided. |{localBranchReleng} branch |XXX |- |{localBranchReleng} branch created; future release engineering proceeds on this branch. |BETA1 builds begin |XXX |- |First beta test snapshot. |BETA2 builds begin |XXX |- |Second beta test snapshot. |BETA3 builds begin |XXX |- |Third beta test snapshot. |RC1 builds begin |XXX |- |First release candidate. |RELEASE builds begin |XXX |- |{localRel}-RELEASE builds begin. |RELEASE announcement |XXX |- |{localRel}-RELEASE press release. |{localRelPrev} EoL |XXX |- |{localRelPrev}-RELEASE no longer supported. |{localRel} EoL |XXX |- |{localRel}-RELEASE no longer supported. |{localBranchStable} EoL |XXX |- |{localBranchStable} no longer supported. |=== "*" indicates "as-needed" items. //// == Status / TODO link:todo/[FreeBSD Release Engineering TODO Page] //// == Additional Information * link:../../../releng/[FreeBSD Release Engineering website]