diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 5deb4ddea874..a6a63eab7326 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -1,1048 +1,1071 @@ .include MAN= aac.4 \ aacraid.4 \ acpi.4 \ ${_acpi_asus.4} \ ${_acpi_asus_wmi.4} \ ${_acpi_dock.4} \ ${_acpi_fujitsu.4} \ ${_acpi_hp.4} \ ${_acpi_ibm.4} \ ${_acpi_panasonic.4} \ ${_acpi_rapidstart.4} \ ${_acpi_sony.4} \ acpi_ged.4 \ acpi_thermal.4 \ acpi_battery.4 \ ${_acpi_toshiba.4} \ acpi_video.4 \ ${_acpi_wmi.4} \ ada.4 \ adm6996fc.4 \ ads111x.4 \ ae.4 \ ${_aesni.4} \ age.4 \ agp.4 \ ahc.4 \ ahci.4 \ ahd.4 \ ${_aibs.4} \ aio.4 \ alc.4 \ ale.4 \ alpm.4 \ altera_atse.4 \ altera_avgen.4 \ altera_jtag_uart.4 \ altera_sdcard.4 \ altq.4 \ amdpm.4 \ ${_amdsbwd.4} \ ${_amdsmb.4} \ ${_amdsmn.4} \ ${_amdtemp.4} \ ${_bxe.4} \ ${_aout.4} \ ${_apic.4} \ arcmsr.4 \ arswitch.4 \ ${_asmc.4} \ at45d.4 \ ata.4 \ ath.4 \ ath_hal.4 \ atkbd.4 \ atkbdc.4 \ ${_atopcase.4} \ atp.4 \ ${_atf_test_case.4} \ ${_atrtc.4} \ ${_attimer.4} \ audit.4 \ auditpipe.4 \ aue.4 \ axe.4 \ axge.4 \ axp.4 \ bce.4 \ bcm5974.4 \ bcma.4 \ bfe.4 \ bge.4 \ ${_bhyve.4} \ bhnd.4 \ bhnd_chipc.4 \ bhnd_pmu.4 \ bhndb.4 \ bhndb_pci.4 \ blackhole.4 \ bnxt.4 \ boottrace.4 \ bpf.4 \ bridge.4 \ bwi.4 \ bwn.4 \ ${_bytgpio.4} \ capsicum.4 \ cardbus.4 \ carp.4 \ cas.4 \ cc_cdg.4 \ cc_chd.4 \ cc_cubic.4 \ cc_dctcp.4 \ cc_hd.4 \ cc_htcp.4 \ cc_newreno.4 \ cc_vegas.4 \ ${_ccd.4} \ ccr.4 \ + cd9660.4 \ cd.4 \ cdce.4 \ cdceem.4 \ cfi.4 \ cfumass.4 \ ${_cgem.4} \ ch.4 \ chromebook_platform.4 \ ${_chvgpio.4} \ ciss.4 \ ${_coretemp.4} \ cp2112.4 \ ${_cpuctl.4} \ cpufreq.4 \ crypto.4 \ ctl.4 \ cue.4 \ cxgb.4 \ cxgbe.4 \ cxgbev.4 \ cyapa.4 \ da.4 \ dc.4 \ dcons.4 \ dcons_crom.4 \ ddb.4 \ devctl.4 \ + devfs.4 \ disc.4 \ disk.4 \ divert.4 \ ${_dpms.4} \ ds1307.4 \ ds3231.4 \ ${_dtrace_provs} \ dummynet.4 \ edsc.4 \ ehci.4 \ em.4 \ ena.4 \ enc.4 \ enic.4 \ epair.4 \ est.4 \ et.4 \ etherswitch.4 \ eventtimers.4 \ exca.4 \ + ext2fs.4 \ e6060sw.4 \ fd.4 \ fdc.4 \ + fdescfs.4 \ fdt.4 \ fdt_pinctrl.4 \ fdtbus.4 \ ffclock.4 \ + ffs.4 \ filemon.4 \ firewire.4 \ ${_ftgpio.4} \ ${_ftwd.4} \ full.4 \ + fusefs.4 \ fwe.4 \ fwip.4 \ fwohci.4 \ fxp.4 \ gdb.4 \ gem.4 \ genet.4 \ genetlink.4 \ geom.4 \ geom_linux_lvm.4 \ geom_uzip.4 \ gif.4 \ ${_gve.4} \ gpio.4 \ gpioiic.4 \ gpiokeys.4 \ gpioled.4 \ gpioths.4 \ gre.4 \ h_ertt.4 \ hconf.4 \ hcons.4 \ hgame.4 \ hidbus.4 \ hidquirk.4 \ hidraw.4 \ hifn.4 \ hkbd.4 \ hms.4 \ hmt.4 \ hpen.4 \ hpet.4 \ ${_hpt27xx.4} \ ${_hptiop.4} \ ${_hptmv.4} \ ${_hptnr.4} \ ${_hptrr.4} \ hsctrl.4 \ htu21.4 \ ${_hv_kvp.4} \ ${_hv_netvsc.4} \ ${_hv_storvsc.4} \ ${_hv_utils.4} \ ${_hv_vmbus.4} \ ${_hv_vss.4} \ hwpmc.4 \ ${_hwpstate_intel.4} \ i2ctinyusb.4 \ iavf.4 \ ichsmb.4 \ ${_ichwd.4} \ icmp.4 \ icmp6.4 \ ida.4 \ ietp.4 \ if_ipsec.4 \ iflib.4 \ ifmib.4 \ ig4.4 \ igmp.4 \ iic.4 \ iic_gpiomux.4 \ iicbb.4 \ iicbus.4 \ iichid.4 \ iicmux.4 \ iicsmb.4 \ ${_igc.4} \ ${_imcsmb.4} \ inet.4 \ inet6.4 \ intpm.4 \ intro.4 \ ${_io.4} \ ${_ioat.4} \ ip.4 \ ip6.4 \ ipfirewall.4 \ ipheth.4 \ ${_ipmi.4} \ ips.4 \ ipsec.4 \ ipw.4 \ ipwfw.4 \ isci.4 \ isl.4 \ ismt.4 \ isp.4 \ ispfw.4 \ ${_itwd.4} \ iwi.4 \ iwifw.4 \ iwm.4 \ iwmfw.4 \ iwn.4 \ iwnfw.4 \ iwlwifi.4 \ iwlwififw.4 \ ixgbe.4 \ ixl.4 \ jedec_dimm.4 \ jme.4 \ kbdmux.4 \ kcov.4 \ keyboard.4 \ kld.4 \ ksyms.4 \ ksz8995ma.4 \ ktls.4 \ ktr.4 \ kue.4 \ ${_kvmclock.4} \ lagg.4 \ le.4 \ led.4 \ lge.4 \ + lindebugfs.4 \ + linprocfs.4 \ + linsysfs.4 \ ${_linux.4} \ liquidio.4 \ lm75.4 \ lo.4 \ lp.4 \ lpbb.4 \ lpt.4 \ ltc430x.4 \ mac.4 \ mac_biba.4 \ mac_bsdextended.4 \ mac_ddb.4 \ mac_ifoff.4 \ mac_ipacl.4 \ mac_lomac.4 \ mac_mls.4 \ mac_none.4 \ mac_ntpd.4 \ mac_partition.4 \ mac_portacl.4 \ mac_priority.4 \ mac_seeotheruids.4 \ mac_stub.4 \ mac_test.4 \ malo.4 \ max44009.4 \ md.4 \ mdio.4 \ me.4 \ mem.4 \ mfi.4 \ ${_mgb.4} \ miibus.4 \ mld.4 \ mlx.4 \ mlx4en.4 \ mlx5en.4 \ mmc.4 \ mmcsd.4 \ mod_cc.4 \ mos.4 \ mouse.4 \ mpi3mr.4 \ mpr.4 \ mps.4 \ mpt.4 \ + mqueuefs.4 \ mrsas.4 \ + msdosfs.4 \ msk.4 \ mtio.4 \ multicast.4 \ muge.4 \ mvs.4 \ mwl.4 \ mwlfw.4 \ mx25l.4 \ mxge.4 \ my.4 \ net80211.4 \ netdump.4 \ netfpga10g_nf10bmac.4 \ netgdb.4 \ netgraph.4 \ netintro.4 \ netlink.4 \ netmap.4 \ ${_nfe.4} \ nfslockd.4 \ ${_nfsmb.4} \ ng_async.4 \ ng_bpf.4 \ ng_bridge.4 \ ng_btsocket.4 \ ng_car.4 \ ng_checksum.4 \ ng_cisco.4 \ ng_deflate.4 \ ng_device.4 \ nge.4 \ ng_echo.4 \ ng_eiface.4 \ ng_etf.4 \ ng_ether.4 \ ng_ether_echo.4 \ ng_frame_relay.4 \ ng_gif.4 \ ng_gif_demux.4 \ ng_hci.4 \ ng_hole.4 \ ng_hub.4 \ ng_iface.4 \ ng_ipfw.4 \ ng_ip_input.4 \ ng_ksocket.4 \ ng_l2cap.4 \ ng_l2tp.4 \ ng_lmi.4 \ ng_macfilter.4 \ ng_mppc.4 \ ng_nat.4 \ ng_netflow.4 \ ng_one2many.4 \ ng_patch.4 \ ng_pipe.4 \ ng_ppp.4 \ ng_pppoe.4 \ ng_pptpgre.4 \ ng_pred1.4 \ ng_rfc1490.4 \ ng_socket.4 \ ng_source.4 \ ng_split.4 \ ng_tag.4 \ ng_tcpmss.4 \ ng_tee.4 \ ng_tty.4 \ ng_ubt.4 \ ng_UI.4 \ ng_vjc.4 \ ng_vlan.4 \ ng_vlan_rotate.4 \ nmdm.4 \ ${_ntb.4} \ ${_ntb_hw_amd.4} \ ${_ntb_hw_intel.4} \ ${_ntb_hw_plx.4} \ ${_ntb_transport.4} \ ${_nda.4} \ ${_if_ntb.4} \ null.4 \ + nullfs.4 \ numa.4 \ nvd.4 \ ${_nvdimm.4} \ nvme.4 \ nvmf.4 \ nvmf_tcp.4 \ nvmft.4 \ ${_nvram.4} \ oce.4 \ ocs_fc.4\ ohci.4 \ openfirm.4 \ orm.4 \ ${_ossl.4} \ ow.4 \ ow_temp.4 \ owc.4 \ ovpn.4 \ ${_padlock.4} \ pass.4 \ pca954x.4 \ pccard.4 \ pccbb.4 \ pcf.4 \ pcf8574.4 \ pcf8591.4 \ ${_pchtherm.4} \ pci.4 \ pcib.4 \ pcic.4 \ pcm.4 \ ${_pf.4} \ ${_pflog.4} \ ${_pflow.4} \ ${_pfsync.4} \ pim.4 \ pms.4 \ polling.4 \ ppbus.4 \ ppc.4 \ ppi.4 \ procdesc.4 \ + procfs.4 \ proto.4 \ ps4dshock.4 \ psm.4 \ pst.4 \ pt.4 \ ptnet.4 \ pts.4 \ pty.4 \ puc.4 \ pwmc.4 \ ${_qat.4} \ ${_qat_c2xxx.4} \ ${_qlxge.4} \ ${_qlxgb.4} \ ${_qlxgbe.4} \ ${_qlnxe.4} \ ral.4 \ random.4 \ rctl.4 \ re.4 \ rgephy.4 \ rights.4 \ rl.4 \ rndtest.4 \ route.4 \ rtnetlink.4 \ rtsx.4 \ rtw88.4 \ rtwn.4 \ rtwnfw.4 \ rtwn_pci.4 \ rue.4 \ sa.4 \ safe.4 \ safexcel.4 \ sbp.4 \ sbp_targ.4 \ scc.4 \ sched_4bsd.4 \ sched_ule.4 \ screen.4 \ scsi.4 \ sctp.4 \ sdhci.4 \ sem.4 \ send.4 \ ses.4 \ ${_sfxge.4} \ sg.4 \ sge.4 \ siba.4 \ siftr.4 \ siis.4 \ simplebus.4 \ sis.4 \ sk.4 \ ${_smartpqi.4} \ smb.4 \ + smbfs.4 \ smbios.4 \ smbus.4 \ smp.4 \ smsc.4 \ snd_als4000.4 \ snd_atiixp.4 \ snd_cmi.4 \ snd_cs4281.4 \ snd_csa.4 \ snd_emu10k1.4 \ snd_emu10kx.4 \ snd_envy24.4 \ snd_envy24ht.4 \ snd_es137x.4 \ snd_fm801.4 \ snd_hda.4 \ snd_hdsp.4 \ snd_hdspe.4 \ snd_ich.4 \ snd_maestro3.4 \ snd_neomagic.4 \ snd_solo.4 \ snd_spicds.4 \ snd_t4dwave.4 \ snd_uaudio.4 \ snd_via8233.4 \ snd_via82c686.4 \ snd_vibes.4 \ sndstat.4 \ snp.4 \ spigen.4 \ ${_spkr.4} \ splash.4 \ ste.4 \ stf.4 \ stge.4 \ ${_sume.4} \ ${_superio.4} \ sym.4 \ syncache.4 \ syncer.4 \ syscons.4 \ sysmouse.4 \ tap.4 \ + tarfs.4 \ targ.4 \ tcp.4 \ tcp_bbr.4 \ tcp_rack.4 \ tdfx.4 \ termios.4 \ textdump.4 \ ti.4 \ timecounters.4 \ + tmpfs.4 \ ${_tpm.4} \ tslog.4 \ tty.4 \ tun.4 \ twe.4 \ tws.4 \ udp.4 \ udplite.4 \ + unionfs.4 \ ure.4 \ vale.4 \ vga.4 \ vge.4 \ viapm.4 \ ${_viawd.4} \ virtio.4 \ virtio_balloon.4 \ virtio_blk.4 \ virtio_console.4 \ virtio_gpu.4 \ virtio_random.4 \ virtio_scsi.4 \ ${_vmci.4} \ vkbd.4 \ vlan.4 \ vxlan.4 \ ${_vmd.4} \ ${_vmm.4} \ ${_vmx.4} \ vr.4 \ vt.4 \ vte.4 \ vtnet.4 \ watchdog.4 \ ${_wbwd.4} \ ${_wdatwd.4} \ wg.4 \ witness.4 \ wlan.4 \ wlan_acl.4 \ wlan_amrr.4 \ wlan_ccmp.4 \ wlan_tkip.4 \ wlan_wep.4 \ wlan_xauth.4 \ wmt.4 \ ${_wpi.4} \ wsp.4 \ xb360gp.4 \ ${_xen.4} \ xhci.4 \ xl.4 \ ${_xnb.4} \ xpt.4 \ zero.4 MLINKS= ads111x.4 ads1013.4 \ ads111x.4 ads1014.4 \ ads111x.4 ads1015.4 \ ads111x.4 ads1113.4 \ ads111x.4 ads1114.4 \ ads111x.4 ads1115.4 MLINKS+=ae.4 if_ae.4 MLINKS+=age.4 if_age.4 MLINKS+=agp.4 agpgart.4 MLINKS+=alc.4 if_alc.4 MLINKS+=ale.4 if_ale.4 MLINKS+=altera_atse.4 atse.4 MLINKS+=altera_sdcard.4 altera_sdcardc.4 MLINKS+=altq.4 ALTQ.4 MLINKS+=ath.4 if_ath.4 MLINKS+=aue.4 if_aue.4 MLINKS+=axe.4 if_axe.4 MLINKS+=bce.4 if_bce.4 MLINKS+=bfe.4 if_bfe.4 MLINKS+=bge.4 if_bge.4 MLINKS+=bnxt.4 if_bnxt.4 MLINKS+=bridge.4 if_bridge.4 MLINKS+=bwi.4 if_bwi.4 MLINKS+=bwn.4 if_bwn.4 MLINKS+=${_bxe.4} ${_if_bxe.4} MLINKS+=cas.4 if_cas.4 MLINKS+=cdce.4 if_cdce.4 MLINKS+=cfi.4 cfid.4 MLINKS+=crypto.4 cryptodev.4 MLINKS+=cue.4 if_cue.4 MLINKS+=cxgb.4 if_cxgb.4 MLINKS+=cxgbe.4 if_cxgbe.4 \ cxgbe.4 vcxgbe.4 \ cxgbe.4 if_vcxgbe.4 \ cxgbe.4 cxl.4 \ cxgbe.4 if_cxl.4 \ cxgbe.4 vcxl.4 \ cxgbe.4 if_vcxl.4 \ cxgbe.4 cc.4 \ cxgbe.4 if_cc.4 \ cxgbe.4 vcc.4 \ cxgbe.4 if_vcc.4 MLINKS+=cxgbev.4 if_cxgbev.4 \ cxgbev.4 cxlv.4 \ cxgbev.4 if_cxlv.4 \ cxgbev.4 ccv.4 \ cxgbev.4 if_ccv.4 MLINKS+=dc.4 if_dc.4 MLINKS+=disc.4 if_disc.4 MLINKS+=edsc.4 if_edsc.4 MLINKS+=em.4 if_em.4 \ em.4 igb.4 \ em.4 if_igb.4 \ em.4 lem.4 \ em.4 if_lem.4 MLINKS+=enc.4 if_enc.4 MLINKS+=epair.4 if_epair.4 MLINKS+=et.4 if_et.4 +MLINKS+=ext2fs.4 ext4fs.4 \ MLINKS+=fd.4 stderr.4 \ fd.4 stdin.4 \ fd.4 stdout.4 MLINKS+=fdt.4 FDT.4 MLINKS+=firewire.4 ieee1394.4 MLINKS+=fwe.4 if_fwe.4 MLINKS+=fwip.4 if_fwip.4 MLINKS+=fxp.4 if_fxp.4 MLINKS+=gem.4 if_gem.4 MLINKS+=genet.4 if_genet.4 MLINKS+=geom.4 GEOM.4 MLINKS+=gif.4 if_gif.4 MLINKS+=gpio.4 gpiobus.4 MLINKS+=gpioths.4 dht11.4 MLINKS+=gpioths.4 dht22.4 MLINKS+=gre.4 if_gre.4 MLINKS+=hpet.4 acpi_hpet.4 MLINKS+=${_hptrr.4} ${_rr232x.4} MLINKS+=${_attimer.4} ${_i8254.4} MLINKS+=ip.4 rawip.4 MLINKS+=ipfirewall.4 ipaccounting.4 \ ipfirewall.4 ipacct.4 \ ipfirewall.4 ipfw.4 MLINKS+=ipheth.4 if_ipheth.4 MLINKS+=ipw.4 if_ipw.4 MLINKS+=iwi.4 if_iwi.4 MLINKS+=iwlwifi.4 if_iwlwifi.4 MLINKS+=iwm.4 if_iwm.4 MLINKS+=iwn.4 if_iwn.4 MLINKS+=ixgbe.4 ix.4 MLINKS+=ixgbe.4 if_ix.4 MLINKS+=ixgbe.4 if_ixgbe.4 MLINKS+=ixl.4 if_ixl.4 MLINKS+=iavf.4 if_iavf.4 MLINKS+=jme.4 if_jme.4 MLINKS+=kue.4 if_kue.4 MLINKS+=lagg.4 trunk.4 MLINKS+=lagg.4 if_lagg.4 MLINKS+=le.4 if_le.4 MLINKS+=lge.4 if_lge.4 MLINKS+=lo.4 loop.4 MLINKS+=lp.4 plip.4 MLINKS+=malo.4 if_malo.4 MLINKS+=md.4 vn.4 MLINKS+=mem.4 kmem.4 MLINKS+=mfi.4 mfi_linux.4 \ mfi.4 mfip.4 MLINKS+=mlx5en.4 mce.4 MLINKS+=mos.4 if_mos.4 +MLINKS+=msdosfs.4 msdos.4 MLINKS+=msk.4 if_msk.4 MLINKS+=mwl.4 if_mwl.4 MLINKS+=mxge.4 if_mxge.4 MLINKS+=my.4 if_my.4 MLINKS+=netfpga10g_nf10bmac.4 if_nf10bmac.4 MLINKS+=netintro.4 net.4 \ netintro.4 networking.4 MLINKS+=${_nfe.4} ${_if_nfe.4} MLINKS+=nge.4 if_nge.4 MLINKS+=openfirm.4 openfirmware.4 MLINKS+=ow.4 onewire.4 MLINKS+=pccbb.4 cbb.4 MLINKS+=pcm.4 snd.4 \ pcm.4 sound.4 MLINKS+=pms.4 pmspcv.4 MLINKS+=ptnet.4 if_ptnet.4 MLINKS+=ral.4 if_ral.4 MLINKS+=re.4 if_re.4 MLINKS+=rl.4 if_rl.4 MLINKS+=rtwn_pci.4 if_rtwn_pci.4 MLINKS+=rue.4 if_rue.4 MLINKS+=scsi.4 cam.4 MLINKS+=scsi.4 scbus.4 MLINKS+=scsi.4 SCSI.4 MLINKS+=sge.4 if_sge.4 MLINKS+=sis.4 if_sis.4 MLINKS+=sk.4 if_sk.4 MLINKS+=smp.4 SMP.4 MLINKS+=smsc.4 if_smsc.4 MLINKS+=snd_envy24.4 snd_ak452x.4 MLINKS+=${_spkr.4} ${_speaker.4} MLINKS+=splash.4 screensaver.4 MLINKS+=ste.4 if_ste.4 MLINKS+=stf.4 if_stf.4 MLINKS+=stge.4 if_stge.4 MLINKS+=syncache.4 syncookies.4 MLINKS+=syscons.4 sc.4 MLINKS+=tap.4 if_tap.4 \ tap.4 vmnet.4 \ tap.4 if_vmnet.4 MLINKS+=tdfx.4 tdfx_linux.4 MLINKS+=ti.4 if_ti.4 MLINKS+=tun.4 if_tun.4 MLINKS+=ure.4 if_ure.4 MLINKS+=vge.4 if_vge.4 MLINKS+=vlan.4 if_vlan.4 MLINKS+=vxlan.4 if_vxlan.4 MLINKS+=${_vmx.4} ${_if_vmx.4} MLINKS+=vr.4 if_vr.4 MLINKS+=vte.4 if_vte.4 MLINKS+=vtnet.4 if_vtnet.4 MLINKS+=watchdog.4 SW_WATCHDOG.4 MLINKS+=wg.4 if_wg.4 MLINKS+=wlan.4 wifi.4 MLINKS+=${_wpi.4} ${_if_wpi.4} MLINKS+=xl.4 if_xl.4 .if ${MACHINE_CPUARCH} == "amd64" || ${MACHINE_CPUARCH} == "i386" _acpi_asus.4= acpi_asus.4 _acpi_asus_wmi.4= acpi_asus_wmi.4 _acpi_dock.4= acpi_dock.4 _acpi_fujitsu.4=acpi_fujitsu.4 _acpi_hp.4= acpi_hp.4 _acpi_ibm.4= acpi_ibm.4 _acpi_panasonic.4=acpi_panasonic.4 _acpi_rapidstart.4=acpi_rapidstart.4 _acpi_sony.4= acpi_sony.4 _acpi_toshiba.4=acpi_toshiba.4 _acpi_wmi.4= acpi_wmi.4 _aesni.4= aesni.4 _aout.4= aout.4 _apic.4= apic.4 _atrtc.4= atrtc.4 _attimer.4= attimer.4 _aibs.4= aibs.4 _amdsbwd.4= amdsbwd.4 _amdsmb.4= amdsmb.4 _amdsmn.4= amdsmn.4 _amdtemp.4= amdtemp.4 _asmc.4= asmc.4 _atopcase.4= atopcase.4 _bxe.4= bxe.4 _bytgpio.4= bytgpio.4 _chvgpio.4= chvgpio.4 _coretemp.4= coretemp.4 _cpuctl.4= cpuctl.4 _dpms.4= dpms.4 _ftgpio.4= ftgpio.4 _ftwd.4= ftwd.4 _hpt27xx.4= hpt27xx.4 _hptiop.4= hptiop.4 _hptmv.4= hptmv.4 _hptnr.4= hptnr.4 _hptrr.4= hptrr.4 _hv_kvp.4= hv_kvp.4 _hv_netvsc.4= hv_netvsc.4 _hv_storvsc.4= hv_storvsc.4 _hv_utils.4= hv_utils.4 _hv_vmbus.4= hv_vmbus.4 _hv_vss.4= hv_vss.4 _hwpstate_intel.4= hwpstate_intel.4 _i8254.4= i8254.4 _ichwd.4= ichwd.4 _if_bxe.4= if_bxe.4 _if_nfe.4= if_nfe.4 _if_urtw.4= if_urtw.4 _if_vmx.4= if_vmx.4 _if_wpi.4= if_wpi.4 _igc.4= igc.4 _imcsmb.4= imcsmb.4 _io.4= io.4 _itwd.4= itwd.4 _kvmclock.4= kvmclock.4 _mgb.4= mgb.4 _nda.4= nda.4 _nfe.4= nfe.4 _nfsmb.4= nfsmb.4 _if_ntb.4= if_ntb.4 _ntb.4= ntb.4 _ntb_hw_amd.4= ntb_hw_amd.4 _ntb_hw_intel.4= ntb_hw_intel.4 _ntb_hw_plx.4= ntb_hw_plx.4 _ntb_transport.4=ntb_transport.4 _nvram.4= nvram.4 _padlock.4= padlock.4 _pchtherm.4= pchtherm.4 _qat.4= qat.4 _qat_c2xxx.4= qat_c2xxx.4 _rr232x.4= rr232x.4 _speaker.4= speaker.4 _spkr.4= spkr.4 _superio.4= superio.4 _tpm.4= tpm.4 _urtw.4= urtw.4 _viawd.4= viawd.4 _vmci.4= vmci.4 _vmd.4= vmd.4 _vmx.4= vmx.4 _wbwd.4= wbwd.4 _wdatwd.4= wdatwd.4 _wpi.4= wpi.4 _xen.4= xen.4 _xnb.4= xnb.4 .endif .if ${MACHINE_CPUARCH} == "amd64" _ioat.4= ioat.4 _nvdimm.4= nvdimm.4 _qlxge.4= qlxge.4 _qlxgb.4= qlxgb.4 _qlxgbe.4= qlxgbe.4 _qlnxe.4= qlnxe.4 _sfxge.4= sfxge.4 _smartpqi.4= smartpqi.4 _sume.4= sume.4 MLINKS+=qlxge.4 if_qlxge.4 MLINKS+=qlxgb.4 if_qlxgb.4 MLINKS+=qlxgbe.4 if_qlxgbe.4 MLINKS+=qlnxe.4 if_qlnxe.4 MLINKS+=sfxge.4 if_sfxge.4 MLINKS+=sume.4 if_sume.4 .if ${MK_BHYVE} != "no" _bhyve.4= bhyve.4 _vmm.4= vmm.4 .endif .endif .if ${MACHINE_CPUARCH} == "amd64" || ${MACHINE_CPUARCH} == "i386" || \ ${MACHINE_CPUARCH} == "aarch64" _gve.4= gve.4 _ipmi.4= ipmi.4 _linux.4= linux.4 _ossl.4= ossl.4 .endif .if ${MACHINE_CPUARCH} == "arm" || ${MACHINE_CPUARCH} == "aarch64" || \ ${MACHINE_CPUARCH} == "riscv" _cgem.4= cgem.4 MLINKS+=cgem.4 if_cgem.4 .endif .if empty(MAN_ARCH) || ${MAN_ARCH} == "all" __arches= ${:!/bin/sh -c "/bin/ls -d ${.CURDIR}/man4.*"!:E} .else __arches= ${MAN_ARCH} .endif .for __arch in ${__arches:O:u} .if exists(${.CURDIR}/man4.${__arch}) SUBDIR+= man4.${__arch} .endif .endfor +.if ${MK_AUTOFS} != "no" +MAN+= autofs.4 +.endif + .if ${MK_BLUETOOTH} != "no" MAN+= ng_bluetooth.4 .endif .if ${MK_CCD} != "no" _ccd.4= ccd.4 .endif .if ${MK_CDDL} != "no" _dtrace_provs= dtrace_audit.4 \ dtrace_io.4 \ dtrace_ip.4 \ dtrace_kinst.4 \ dtrace_lockstat.4 \ dtrace_proc.4 \ dtrace_sched.4 \ dtrace_sctp.4 \ dtrace_tcp.4 \ dtrace_udp.4 \ dtrace_udplite.4 MLINKS+= dtrace_audit.4 dtaudit.4 .endif .if ${MK_EFI} != "no" MAN+= efidev.4 MLINKS+= efidev.4 efirtc.4 .endif .if ${MK_ISCSI} != "no" MAN+= cfiscsi.4 MAN+= iscsi.4 MAN+= iser.4 .endif .if ${MK_OFED} != "no" MAN+= mlx4ib.4 MAN+= mlx5ib.4 .endif .if ${MK_MLX5TOOL} != "no" MAN+= mlx5io.4 .endif .if ${MK_TESTS} != "no" ATF= ${SRCTOP}/contrib/atf .PATH: ${ATF}/doc _atf_test_case.4= atf-test-case.4 .endif .if ${MK_PF} != "no" _pf.4= pf.4 _pflog.4= pflog.4 _pflow.4= pflow.4 _pfsync.4= pfsync.4 .endif .if ${MK_USB} != "no" MAN+= \ otus.4 \ otusfw.4 \ rsu.4 \ rsufw.4 \ rtwn_usb.4 \ rum.4 \ run.4 \ runfw.4 \ u3g.4 \ uark.4 \ uart.4 \ uath.4 \ ubsa.4 \ ubser.4 \ ubtbcmfw.4 \ uchcom.4 \ ucom.4 \ ucycom.4 \ udav.4 \ udbp.4 \ udl.4 \ uep.4 \ ufoma.4 \ uftdi.4 \ ugen.4 \ ugold.4 \ uhci.4 \ uhid.4 \ uhso.4 \ uipaq.4 \ ukbd.4 \ uled.4 \ ulpt.4 \ umass.4 \ umcs.4 \ umct.4 \ umodem.4 \ umoscom.4 \ ums.4 \ unix.4 \ upgt.4 \ uplcom.4 \ ural.4 \ urio.4 \ urndis.4 \ ${_urtw.4} \ usb.4 \ usb_quirk.4 \ usb_template.4 \ usbhid.4 \ usfs.4 \ uslcom.4 \ uvisor.4 \ uvscom.4 \ zyd.4 MLINKS+=otus.4 if_otus.4 MLINKS+=rsu.4 if_rsu.4 MLINKS+=rtwn_usb.4 if_rtwn_usb.4 MLINKS+=rum.4 if_rum.4 MLINKS+=run.4 if_run.4 MLINKS+=u3g.4 u3gstub.4 MLINKS+=uath.4 if_uath.4 MLINKS+=udav.4 if_udav.4 MLINKS+=upgt.4 if_upgt.4 MLINKS+=ural.4 if_ural.4 MLINKS+=urndis.4 if_urndis.4 MLINKS+=${_urtw.4} ${_if_urtw.4} MLINKS+=zyd.4 if_zyd.4 .endif .include diff --git a/share/man/man5/autofs.5 b/share/man/man4/autofs.4 similarity index 99% rename from share/man/man5/autofs.5 rename to share/man/man4/autofs.4 index e82df1929877..a721a6e27a53 100644 --- a/share/man/man5/autofs.5 +++ b/share/man/man4/autofs.4 @@ -1,135 +1,135 @@ .\" Copyright (c) 2014 The FreeBSD Foundation .\" .\" This software was developed by Edward Tomasz Napierala under sponsorship .\" from the FreeBSD Foundation. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 December 2, 2017 -.Dt AUTOFS 5 +.Dt AUTOFS 4 .Os .Sh NAME .Nm autofs .Nd "automounter filesystem" .Sh SYNOPSIS To compile this driver into the kernel, place the following line in the kernel configuration file: .Bd -ragged -offset indent .Cd "options AUTOFS" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent autofs_load="YES" .Ed .Sh DESCRIPTION The .Nm driver is the kernel component of the automounter infrastructure. Its job is to pass mount requests to the .Xr automountd 8 daemon, and pause the processes trying to access the automounted filesystem until the mount is completed. It is mounted by the .Xr automount 8 . .Sh OPTIONS These options are available when mounting .Nm file systems: .Bl -tag -width indent .It Cm master_options Mount options for all filesystems specified in the map entry. .It Cm master_prefix Filesystem mountpoint prefix. .El .Sh SYSCTL VARIABLES The following variables are available as both .Xr sysctl 8 variables and .Xr loader 8 tunables: .Bl -tag -width indent .It Va vfs.autofs.debug Verbosity level for log messages from the .Nm driver. Set to 0 to disable logging or 1 to warn about potential problems. Larger values enable debugging output. Defaults to 1. .It Va vfs.autofs.interruptible Set to 1 to allow mount requests to be interrupted by signal. Defaults to 1. .It Va vfs.autofs.retry_delay Number of seconds before retrying mount requests. Defaults to 1. .It Va vfs.autofs.retry_attempts Number of attempts before failing mount. Defaults to 3. .It Va vfs.autofs.cache Number of seconds to wait before reinvoking .Xr automountd 8 for any given file or directory. Defaults to 600. .It Va vfs.autofs.timeout Number of seconds to wait for .Xr automountd 8 to handle the mount request. Defaults to 30. .It Va vfs.autofs.mount_on_stat Set to 1 to trigger mount on .Xr stat 2 on mountpoint. Defaults to 0. .El .Sh EXAMPLES To unmount all mounted .Nm filesystems: .Pp .Dl "umount -At autofs" .Pp To mount .Nm filesystems specified in .Xr auto_master 5 : .Pp .Dl "automount" .Sh SEE ALSO .Xr auto_master 5 , .Xr automount 8 , .Xr automountd 8 , .Xr autounmountd 8 .Sh HISTORY The .Nm driver first appeared in .Fx 10.1 . .Sh AUTHORS The .Nm was developed by .An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org under sponsorship from the FreeBSD Foundation. diff --git a/share/man/man5/cd9660.5 b/share/man/man4/cd9660.4 similarity index 99% rename from share/man/man5/cd9660.5 rename to share/man/man4/cd9660.4 index 224816e16c57..0e4fd33637cb 100644 --- a/share/man/man5/cd9660.5 +++ b/share/man/man4/cd9660.4 @@ -1,81 +1,81 @@ .\" .\" Copyright (c) 2017 Enji Cooper .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (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 25, 2023 -.Dt CD9660 5 +.Dt CD9660 4 .Os .Sh NAME .Nm cd9660 .Nd "ISO-9660 file system" .Sh SYNOPSIS To link into the kernel: .Bd -ragged -offset indent .Cd "options CD9660" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent cd9660_load="YES" .Ed .Sh DESCRIPTION The .Nm driver will permit the .Fx kernel to access the .Tn cd9660 file system. .Sh EXAMPLES To mount a .Nm volume located on .Pa /dev/cd0 : .Pp .Dl "mount -t cd9660 /dev/cd0 /mnt" .Sh SEE ALSO .Xr nmount 2 , .Xr unmount 2 , .Xr cd 4 , .Xr fstab 5 , .Xr mount 8 , .Xr mount_cd9660 8 .Sh HISTORY The .Nm driver first appeared in .Bx 4.4 Lite . .Sh AUTHORS .An -nosplit The .Nm kernel implementation was originally written by .An Pace Willisson Aq Mt pace@blitz.com and .An Atsushi Murai Aq Mt amurai@spec.co.jp . .Pp This manual page was written by .An Enji Cooper Aq Mt ngie@FreeBSD.org . diff --git a/share/man/man5/devfs.5 b/share/man/man4/devfs.4 similarity index 99% rename from share/man/man5/devfs.5 rename to share/man/man4/devfs.4 index 0f914f671bf8..c90835570127 100644 --- a/share/man/man5/devfs.5 +++ b/share/man/man4/devfs.4 @@ -1,147 +1,147 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . All rights reserved. .\" .\" Copyright (c) 1992, 1993, 1994 .\" The Regents of the University of California. All rights reserved. .\" All rights reserved. .\" .\" This code is derived from software donated to Berkeley by .\" Jan-Simon Pendry. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 June 30, 2022 -.Dt DEVFS 5 +.Dt DEVFS 4 .Os .Sh NAME .Nm devfs .Nd device file system .Sh SYNOPSIS .Bd -literal devfs /dev devfs rw 0 0 .Ed .Sh DESCRIPTION The device file system, or .Nm , provides access to kernel's device namespace in the global file system namespace. The conventional mount point is .Pa /dev . .Pp The file system includes several directories, links, symbolic links and devices, some of which can also be written. In a chroot'ed environment, .Xr devfs 8 can be used to create a new .Pa /dev mount point. .Pp The .Xr mknod 8 tool can be used to recover deleted device entries under .Nm . .Pp The .Xr fdescfs 5 filesystem is an alternate means for populating .Pa /dev/fd . The character devices that both .Nm and .Xr fdescfs 5 present in .Pa /dev/fd correspond to the open file descriptors of the process accessing the directory. .Nm only creates files for the standard file descriptors .Pa 0 , .Pa 1 and .Pa 2 . .Xr fdescfs 5 creates files for all open descriptors. .Pp The options are as follows: .Bl -tag -width indent .It Fl o Ar options Use the specified mount .Ar options , as described in .Xr mount 8 . The following devfs file system-specific options are available: .Bl -tag -width indent .It Cm ruleset Ns No = Ns Ar ruleset Set ruleset number .Ar ruleset as the current ruleset for the mount-point and apply all its rules. If the ruleset number .Ar ruleset does not exist, an empty ruleset with the number .Ar ruleset is created. See .Xr devfs 8 for more information on working with devfs rulesets. .El .El .Sh FILES .Bl -tag -width /dev/XXXX -compact .It Pa /dev The normal .Nm mount point. .El .Sh EXAMPLES To mount a .Nm volume located on .Pa /mychroot/dev : .Pp .Dl "mount -t devfs devfs /mychroot/dev" .Sh SEE ALSO .Xr fdescfs 5 , .Xr devfs 8 , .Xr mount 8 , .Xr make_dev 9 .Sh HISTORY The .Nm file system first appeared in .Fx 2.0 . It became the preferred method for accessing devices in .Fx 5.0 and the only method in .Fx 6.0 . The .Nm manual page first appeared in .Fx 2.2 . .Sh AUTHORS The .Nm manual page was written by .An Mike Pritchard Aq Mt mpp@FreeBSD.org . diff --git a/share/man/man5/ext2fs.5 b/share/man/man4/ext2fs.4 similarity index 99% rename from share/man/man5/ext2fs.5 rename to share/man/man4/ext2fs.4 index 7504a144496f..816ea942d29f 100644 --- a/share/man/man5/ext2fs.5 +++ b/share/man/man4/ext2fs.4 @@ -1,104 +1,104 @@ .\" .\" Copyright (c) 2006 Craig Rodrigues .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (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 December 30, 2018 -.Dt EXT2FS 5 +.Dt EXT2FS 4 .Os .Sh NAME .Nm ext2fs .Nd "ext2/ext3/ext4 file system" .Sh SYNOPSIS To link into the kernel: .Bd -ragged -offset indent .Cd "options EXT2FS" .Ed .Pp To load as a kernel loadable module: .Pp .Dl "kldload ext2fs" .Sh DESCRIPTION The .Nm driver will permit the .Fx kernel to access ext2 file systems and its derivatives. It currently implements most of the features required by .Em ext3 and .Em ext4 file systems. Support for Extended Attributes in .Em ext4 is experimental. Journalling and encryption are currently not supported. .Sh EXAMPLES To mount a .Nm volume located on .Pa /dev/ada1s1 : .Pp .Dl "mount -t ext2fs /dev/ada1s1 /mnt" .Sh SEE ALSO .Xr nmount 2 , .Xr unmount 2 , .Xr fstab 5 , .Xr mount 8 .Sh HISTORY The .Nm driver first appeared in .Fx 2.2 . .Sh AUTHORS .An -nosplit The .Nm kernel implementation is derived from code written, or modified, by .An Godmar Back using the UFS CSRG sources for CMU Mach. .Pp .An John Dyson did the initial port to .Fx . .An Aditya Sarawgi merged important parts of the allocation code from a clean-room .Nx implementation. .An Zheng Liu and .An Fedor Uporov implemented the read and write support respectively for .Em ext4 filesystems. The .Fx community has contributed a huge amount of modifications. .Pp The initial version of this manual page was written by .An Craig Rodrigues Aq Mt rodrigc@FreeBSD.org . diff --git a/share/man/man5/fdescfs.5 b/share/man/man4/fdescfs.4 similarity index 99% rename from share/man/man5/fdescfs.5 rename to share/man/man4/fdescfs.4 index fa260cbc12f3..4b51c2bad369 100644 --- a/share/man/man5/fdescfs.5 +++ b/share/man/man4/fdescfs.4 @@ -1,218 +1,218 @@ .\" Copyright (c) 2021 The FreeBSD Foundation, Inc. .\" .\" Copyright (c) 1996 .\" Mike Pritchard . All rights reserved. .\" .\" Copyright (c) 1992, 1993, 1994 .\" The Regents of the University of California. All rights reserved. .\" All rights reserved. .\" .\" This code is derived from software donated to Berkeley by .\" Jan-Simon Pendry. .\" .\" Parts of this documentation was written by .\" Konstantin Belousov under sponsorship .\" from the FreeBSD Foundation. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 Jul 11, 2023 -.Dt FDESCFS 5 +.Dt FDESCFS 4 .Os .Sh NAME .Nm fdescfs .Nd file-descriptor file system .Sh SYNOPSIS .Bd -literal fdescfs /dev/fd fdescfs rw 0 0 .Ed .Sh DESCRIPTION The file-descriptor file system, or .Nm , provides access to the per-process file descriptor namespace in the global file system namespace. The conventional mount point is .Pa /dev/fd . .Pp The file system's contents appear as a list of numbered files which correspond to the open files of the process reading the directory. The files .Pa /dev/fd/0 through .Pa /dev/fd/# refer to file descriptors which can be accessed through the file system. .Pp The following mount options can be used when mounting .Nm filesystem: .Bl -tag -width linrdlnk .It Cm nodup For file descriptors referencing vnodes, instead of the .Xr dup 2 semantic described above, implement re-opening of the referenced vnode. See below for more details. .It Cm linrdlnk Report the type of the .Nm vnode as .Dv VLNK instead of .Fx traditional .Dv VCHR . For .Xr linux 4 ABI compatibility mount .Nm volume with the .Cm linrdlnk option. .It Cm rdlnk Treat .Nm vnodes as symbolic links consistently, in particular, follow the resolved name for the name lookups. This option is strictly stronger than the .Cm linrdlnk option, it changes not only the type returned by .Xr stat 2 , but also causes the .Nm files to behave as symlinks. .El .Pp For .Nm mounted without the .Cm nodup mount option, if the file descriptor is open and the mode the file is being opened with is a subset of the mode of the existing descriptor, the call: .Bd -literal -offset indent fd = open("/dev/fd/0", mode); .Ed .Pp and the call: .Bd -literal -offset indent fd = fcntl(0, F_DUPFD, 0); .Ed .Pp are equivalent. Flags to the .Xr open 2 call other than .Dv O_RDONLY , .Dv O_WRONLY and .Dv O_RDWR are ignored. .Pp For .Nm mounted with the .Cm nodup option, and file descriptor referencing a vnode, the call: .Bd -literal -offset indent fd = open("/dev/fd/0", mode); .Ed .Pp reopens the referenced vnode with the specified .Fa mode . In other words, the .Fn open call above is equivalent to .Bd -literal -offset indent fd = openat(0, "", O_EMPTY_PATH, mode); .Ed .Pp In particular, if the file descriptor was opened with the .Dv O_PATH flag, then either .Dv O_EMPTY_PATH or .Fn open over .Nm mount with .Cm nodup option allows one to convert it to a regularly opened file, assuming that the current permissions allow the requested .Fa mode . .Pp .Em "Note:" .Pa /dev/fd/0 , .Pa /dev/fd/1 and .Pa /dev/fd/2 files are created by default when devfs alone is mounted. .Nm creates entries for all file descriptors opened by the process. .Sh FILES .Bl -tag -width /dev/stderr -compact .It Pa /dev/fd/# .El .Sh EXAMPLES To mount a .Nm volume located on .Pa /dev/fd : .Pp .Dl "mount -t fdescfs none /dev/fd" .Pp For .Xr linux 4 ABI compatibility: .Pp .Dl "mount -t fdescfs -o linrdlnk none /compat/linux/dev/fd" .Pp For substitute of .Dv O_EMPTY_PATH flag use: .Pp .Dl "mount -t fdescfs -o nodup none /dev/fdpath" .Sh SEE ALSO .Xr devfs 5 , .Xr mount 8 .Sh HISTORY The .Nm file system first appeared in .Bx 4.4 . The .Nm manual page first appeared in .Fx 2.2 . .Sh AUTHORS .An -nosplit The .Nm manual page was written by .An Mike Pritchard Aq Mt mpp@FreeBSD.org , and was based on the manual page written by .An Jan-Simon Pendry . diff --git a/share/man/man7/ffs.7 b/share/man/man4/ffs.4 similarity index 99% rename from share/man/man7/ffs.7 rename to share/man/man4/ffs.4 index 7d003443f32a..fa0cf9be1510 100644 --- a/share/man/man7/ffs.7 +++ b/share/man/man4/ffs.4 @@ -1,328 +1,328 @@ .\" Copyright (c) 2001 Networks Associates Technology, Inc. .\" All rights reserved. .\" .\" This software was developed for the FreeBSD Project by Chris .\" Costello at Safeport Network Services and NAI Labs, the Security .\" Research Division of Network Associates, Inc. under DARPA/SPAWAR .\" contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA CHATS .\" research program. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 May 3, 2020 -.Dt FFS 7 +.Dt FFS 4 .Os .Sh NAME .Nm ffs .Nd Berkeley fast file system .Sh SYNOPSIS In the kernel configuration file: .Cd "options FFS" .Cd "options QUOTA" .Cd "options SOFTUPDATES" .Cd "options SUIDDIR" .Cd "options UFS_ACL" .Cd "options UFS_DIRHASH" .Cd "options UFS_EXTATTR" .Cd "options UFS_EXTATTR_AUTOSTART" .Cd "options UFS_GJOURNAL" .Pp In .Xr fstab 5 : .Bd -literal -compact /dev/disk0a /mnt ufs rw 1 1 .Ed .Sh DESCRIPTION The Berkeley fast file system provides facilities to store file system data onto a disk device. .Nm has been optimized over the years for speed and reliability and is the default .Fx file system. .Ss Quotas .Bl -tag -width 2n .It Cd "options QUOTA" This option allows system administrators to set limits on disk usage on a per-user basis. Quotas can be used only on file systems mounted with the .Cm quota option; see .Xr quota 1 and .Xr edquota 8 . .El .Ss Soft Updates .Bl -tag -width 2n .It Cd "options SOFTUPDATES" The soft updates feature tracks writes to the disk and enforces metadata update dependencies (e.g., updating free block maps) to ensure that the file system remains consistent. .Pp To create a new file system with the soft updates enabled, use .Xr newfs 8 command: .Pp .D1 Nm newfs Fl U Ar fs .Pp .Ar fs can be either a mount point listed in .Xr fstab 5 .Pq e.g. , Pa /usr , or a disk device .Pq e.g., Pa /dev/da0a . .Pp It is possible to enable soft updates on an .Em unmounted file system by using .Xr tunefs 8 command: .Pp .D1 Nm tunefs Fl n Cm enable Ar fs .Pp Soft updates can also add journaling that reduces the time spent by .Xr fsck_ffs 8 cleaning up a filesystem after a crash from several minutes to a few seconds. The journal is placed in an inode named .Pa .sujournal , and is kept as a circular log of segments containing records that describe metadata operations. .Pp To create a new file system with both the soft updates and soft updates journaling enabled, use the following command: .Pp .D1 Nm newfs Fl j Ar fs .Pp This runs .Xr tunefs 8 command after .Xr newfs 8 command with .Fl U flag enabled. It is possible to enable soft updates journaling on an .Em unmounted file system by using .Xr tunefs 8 command: .Pp .D1 Nm tunefs Fl j Cm enable Ar fs .Pp This flag automatically enables the soft updates feature when it is not enabled. Note that this .Xr tunefs 8 command will fail if a file .Pa .sujournal already exists before enabling the soft updates journaling. .El .Ss File Ownership Inheritance .Bl -tag -width 2n .It Cd "options SUIDDIR" For use in file sharing environments on networks including .Tn "Microsoft Windows" and .Tn "Apple Macintosh" computers, this option allows files on file systems mounted with the .Cm suiddir option to inherit the ownership of its directory, i.e., .Dq "if it's my directory, it must be my file." .El .Ss Access Control Lists .Bl -tag -width 2n .It Cd "options UFS_ACL" Access control lists allow the association of fine-grained discretionary access control information with files and directories. This option requires the presence of the .Dv UFS_EXTATTR option, and it is recommended that .Dv UFS_EXTATTR_AUTOSTART is included as well, so that ACLs are enabled atomically upon mounting the file system. .El .Pp In order to enable support for ACLs, two extended attributes must be available in the .Dv EXTATTR_NAMESPACE_SYSTEM namespace: .Pa posix1e.acl_access , which holds the access ACL, and .Pa posix1e.acl_default , which holds the default ACL for directories. If you are using file system extended attributes, the following commands may be used to allocate space for and create the necessary EA backing files for ACLs in the root of each file system. In these examples, the root file system is used; see .Sx "Extended Attributes" for more details. .Bd -literal -offset indent mkdir -p /.attribute/system cd /.attribute/system extattrctl initattr -p / 388 posix1e.acl_access extattrctl initattr -p / 388 posix1e.acl_default .Ed .Pp On the next mount of the root file system, the attributes will be automatically started if .Dv UFS_EXTATTR_AUTOSTART is included in the kernel configuration, and ACLs will be enabled. .Ss Directory Hashing .Bl -tag -width 2n .It Cd "options UFS_DIRHASH" Implements a hash-based lookup scheme for directories in order to speed up accesses to very large directories. .El .Ss Extended Attributes .Bl -tag -width 2n .It Cd "options UFS_EXTATTR" Extended attributes allow the association of additional arbitrary metadata with files and directories, which can be assigned and retrieved from userland as well as from within the kernel; see .Xr extattrctl 8 . .It Cd "options UFS_EXTATTR_AUTOSTART" If this option is defined, .Nm will search for a .Pa .attribute subdirectory of the file system root during the mount operation. If found, extended attribute support will be automatically started for that file system. .El .Ss GEOM-based Journaling .Bl -tag -width 2n .It Cd "options UFS_GJOURNAL" Implements a block level journaling of a UFS file system, which is for both data and metadata. To enable this, create a .Xr gjournal 8 GEOM provider for a block device by using the following command: .Pp .D1 Nm gjournal label Ar da0 .Pp In this example, .Pa /dev/da0 is used as the target block device, and .Pa /dev/da0.journal is created. Then create a new file system by using .Xr newfs 8 with the block level journaling flag and mount it: .Pp .D1 Nm newfs Fl J Ar /dev/da0.journal .D1 Nm mount Fl o Cm async Ar /dev/da0.journal Ar /mnt .Pp .Cm async option is not mandatory but recommended for better performance because the journaling guarantees the consistency of an .Cm async mount. .Pp It is also possible to enable the block level journaling on an existing file system. To do so, use .Xr gjournal 8 utility to label the underlying block device and .Xr tunefs 8 utility to enable the block level journaling flag: .Pp .D1 Nm gjournal label Ar da0 .D1 Nm tunefs Fl J Cm enable Ar /dev/da0.journal .D1 Nm mount Fl o Cm async Ar /dev/da0.journal Ar /mnt .El .Ss Xr sysctl 8 MIBs The following .Xr sysctl 8 MIBs are defined for use with .Nm : .Bl -hang -width ".Va vfs.ffs.doreallocblk" .It Va vfs.ffs.doasyncfree Asynchronously write out modified i-node and indirect blocks upon reallocating file system blocks to be contiguous. .Pq Default: 1 . .It Va vfs.ffs.doreallocblks Enable support for the rearrangement of blocks to be contiguous. .Pq Default: 1 . .El .Sh HISTORY The .Nm manual page first appeared in .Fx 4.5 . .Sh SEE ALSO .Xr quota 1 , .Xr acl 3 , .Xr extattr 3 , .Xr edquota 8 , .Xr extattrctl 8 , .Xr fsck_ffs 8 , .Xr sysctl 8 , .Xr tunefs 8 .Rs .%A M. McKusick .%A W. Joy .%A S. Leffler .%A R. Fabry .%D August 1984 .%T "A Fast File System for UNIX" .%J "ACM Transactions on Computer Systems" .%N 2 .%V 3 .%P 181-197 .Re .Rs .%A M. McKusick .%D June 2000 .%T "Soft Updates: A Technique for Eliminating Most Synchronous Writes in the Fast Filesystem" .%J "Proceedings of the Freenix Track at the 1999 Usenix Annual Technical Conference" .%P 71-84 .Re .Rs .%A M. McKusick .%A J. Roberson .%D May 2010 .%T "Journaled Soft-updates" .%J "BSD Canada Conference 2010 (BSDCan)" .Re diff --git a/share/man/man5/fusefs.5 b/share/man/man4/fusefs.4 similarity index 99% rename from share/man/man5/fusefs.5 rename to share/man/man4/fusefs.4 index 987e7f898eca..33c31f355e09 100644 --- a/share/man/man5/fusefs.5 +++ b/share/man/man4/fusefs.4 @@ -1,136 +1,136 @@ .\" .\" SPDX-License-Identifier: BSD-2-Clause .\" .\" Copyright (c) 2019 The FreeBSD Foundation .\" .\" This documentation was written by BFF Storage Systems, LLC under .\" sponsorship from the FreeBSD Foundation. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 July 31, 2019 -.Dt FUSEFS 5 +.Dt FUSEFS 4 .Os .Sh NAME .Nm fusefs .Nd "File system in USErspace" .Sh SYNOPSIS To link into the kernel: .Bd -ragged -offset indent .Cd "options FUSEFS" .Ed .Pp To load as a loadable kernel module: .Pp .Dl "kldload fusefs" .Sh DESCRIPTION The .Nm driver implements a file system that is serviced by a userspace program. .Pp There are many uses for .Nm . Userspace daemons can access libraries or programming languages that cannot run in kernel-mode, for example. .Nm is also useful for developing and debugging file systems, because a crash of the daemon will not take down the entire operating system. Finally, the .Nm API is portable. Many daemons can run on multiple operating systems with minimal modifications. .Sh SYSCTL VARIABLES The following .Xr sysctl 8 variables are available: .Bl -tag -width indent .It Va vfs.fusefs.kernelabi_major Major version of the FUSE kernel ABI supported by this driver. .It Va vfs.fusefs.kernelabi_minor Minor version of the FUSE kernel ABI supported by this driver. .It Va vfs.fusefs.data_cache_mode Controls how .Nm will cache file data for pre-7.23 file systems. A value of 0 will disable caching entirely. Every data access will be forwarded to the daemon. A value of 1 will select write-through caching. Reads will be cached in the VFS layer as usual. Writes will be immediately forwarded to the daemon, and also added to the cache. A value of 2 will select write-back caching. Reads and writes will both be cached, and writes will occasionally be flushed to the daemon by the page daemon. Write-back caching is usually unsafe, especially for FUSE file systems that require network access. .Pp FUSE file systems using protocol 7.23 or later specify their cache behavior on a per-mountpoint basis, ignoring this sysctl. .It Va vfs.fusefs.stats.filehandle_count Current number of open FUSE file handles. .It Va vfs.fusefs.stats.lookup_cache_hits Total number of lookup cache hits. .It Va vfs.fusefs.stats.lookup_cache_misses Total number of lookup cache misses. .It Va vfs.fusefs.stats.node_count Current number of allocated FUSE vnodes. .It Va vfs.fusefs.stats.ticket_count Current number of allocated FUSE tickets, which is roughly equal to the number of FUSE operations currently being processed by daemons. .\" Undocumented sysctls .\" ==================== .\" vfs.fusefs.enforce_dev_perms: I don't understand it well enough. .\" vfs.fusefs.iov_credit: I don't understand it well enough .\" vfs.fusefs.iov_permanent_bufsize: I don't understand it well enough .El .Sh SEE ALSO .Xr mount_fusefs 8 .Sh HISTORY The .Nm fuse driver was written as the part of the .Fx implementation of the FUSE userspace file system framework (see .Lk https://github.com/libfuse/libfuse ) and first appeared in the .Pa sysutils/fusefs-kmod port, supporting .Fx 6.0 . It was added to the base system in .Fx 10.0 , and renamed to .Nm for .Fx 12.1 . .Sh AUTHORS .An -nosplit The .Nm fuse driver was originally written by .An Csaba Henk as a Google Summer of Code project in 2005. It was further developed by .An Ilya Putsikau during Google Summer of Code 2011, and that version was integrated into the base system by .An Attilio Rao Aq Mt attilio@FreeBSD.org . .Pp This manual page was written by .An Alan Somers Aq Mt asomers@FreeBSD.org . diff --git a/share/man/man5/lindebugfs.5 b/share/man/man4/lindebugfs.4 similarity index 99% rename from share/man/man5/lindebugfs.5 rename to share/man/man4/lindebugfs.4 index 8e385be7d743..d78a12c44714 100644 --- a/share/man/man5/lindebugfs.5 +++ b/share/man/man4/lindebugfs.4 @@ -1,95 +1,95 @@ .\" SPDX-License-Identifier: BSD-2-Clause .\" .\" Copyright (c) 2022, Jake Freeland .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 August 10, 2022 -.Dt LINDEBUGFS 5 +.Dt LINDEBUGFS 4 .Os .Sh NAME .Nm lindebugfs .Nd Linux file system for debugging .Sh SYNOPSIS .Bd -literal lindebugfs /sys/kernel/debug lindebugfs rw 0 0 .Ed .Sh DESCRIPTION The debug file system, or debugfs, makes process debugging easier by providing a simple API for data transfer between the kernel and user space. Debugfs is not a general-purpose file system and should not be used as a storage medium. Instead, developers can implement the debugfs interface in their code to generate debug information about their program at runtime. FreeBSD's .Nm uses the .Xr pseudofs 9 file system construction kit to model itself after Linux's debugfs. The .Nm API is intended for use with programs that take advantage of FreeBSD's LinuxKPI compatibility layer. .Pp When mounted, .Nm will populate with pseudo files from any running process that calls .Nm debugfs_create_file() . Since .Nm is a pseudo file system, file contents will be generated dynamically based on program provided file operations. The current .Nm implementation formally supports seq_file and simple_attr_file virtual file formats. .Sh EXAMPLES Load the .Nm kernel module: .Pp .Dl "kldload lindebugfs" .Pp Mount the .Nm file system on .Pa /sys/kernel/debug : .Pp .Dl "mount -t lindebugfs lindebugfs /sys/kernel/debug" .Sh SEE ALSO .Xr linprocfs 5 , .Xr linsysfs 5 , .Xr pseudofs 9 , .Xr linux 4 , .Xr mount 1 .Sh HISTORY The .Nm file system first appeared in .Fx 12.1 . .Sh AUTHORS .An -nosplit The initial implementation for .Nm was created by Matthew Macy. This manual page was written by Jake Freeland. diff --git a/share/man/man5/linprocfs.5 b/share/man/man4/linprocfs.4 similarity index 99% rename from share/man/man5/linprocfs.5 rename to share/man/man4/linprocfs.4 index 6b30d944b14b..f5ab7d9a10ad 100644 --- a/share/man/man5/linprocfs.5 +++ b/share/man/man4/linprocfs.4 @@ -1,98 +1,98 @@ .\" Written by Garrett Wollman .\" This file is in the public domain. .\" .Dd November 13, 2019 -.Dt LINPROCFS 5 +.Dt LINPROCFS 4 .Os .Sh NAME .Nm linprocfs .Nd Linux process file system .Sh SYNOPSIS .Bd -literal linproc /compat/linux/proc linprocfs rw 0 0 .Ed .Sh DESCRIPTION The Linux process file system, or .Nm , emulates a subset of Linux' process file system and is required for the complete operation of some Linux binaries. .Pp The .Nm provides a two-level view of process space. At the highest level, processes themselves are named, according to their process ids in decimal, with no leading zeros. There is also a special node called .Pa self which always refers to the process making the lookup request. .Pp Each node is a directory containing several files: .Bl -tag -width status .It Pa exe A reference to the vnode from which the process text was read. This can be used to gain access to the process' symbol table, or to start another copy of the process. .It Pa mem The complete virtual memory image of the process. Only those addresses which exist in the process can be accessed. Reads and writes to this file modify the process. Writes to the text segment remain private to the process. .El .Pp Each node is owned by the process's user, and belongs to that user's primary group, except for the .Pa mem node, which belongs to the .Li kmem group. .Sh FILES .Bl -tag -width /compat/linux/proc/self/XXXXXXX -compact .It Pa /compat/linux/proc The normal mount point for the .Nm . .It Pa /compat/linux/proc/cpuinfo CPU vendor and model information in human-readable form. .It Pa /compat/linux/proc/meminfo System memory information in human-readable form. .It Pa /compat/linux/proc/pid A directory containing process information for process .Pa pid . .It Pa /compat/linux/proc/self A directory containing process information for the current process. .It Pa /compat/linux/proc/self/exe The executable image for the current process. .It Pa /compat/linux/proc/self/mem The complete virtual address space of the current process. .El .Sh EXAMPLES To mount a .Nm file system on .Pa /compat/linux/proc : .Pp .Dl "mount -t linprocfs linproc /compat/linux/proc" .Sh SEE ALSO .Xr mount 2 , .Xr unmount 2 , .Xr linux 4 , .Xr procfs 5 , .Xr pseudofs 9 .Sh HISTORY The .Nm first appeared in .Fx 4.0 . .Sh AUTHORS .An -nosplit The .Nm was derived from .Nm procfs by .An Pierre Beyssac . This manual page was written by .An Dag-Erling Sm\(/orgrav , based on the .Xr procfs 5 manual page by .An Garrett Wollman . diff --git a/share/man/man5/linsysfs.5 b/share/man/man4/linsysfs.4 similarity index 99% rename from share/man/man5/linsysfs.5 rename to share/man/man4/linsysfs.4 index f87f791c5f94..64270fe753d4 100644 --- a/share/man/man5/linsysfs.5 +++ b/share/man/man4/linsysfs.4 @@ -1,98 +1,98 @@ .\" Written by Garrett Wollman .\" This file is in the public domain. .\" .Dd November 13, 2019 -.Dt LINSYSFS 5 +.Dt LINSYSFS 4 .Os .Sh NAME .Nm linsysfs .Nd Linux kernel objects file system .Sh SYNOPSIS .Bd -literal linsys /compat/linux/sys linsysfs rw 0 0 .Ed .Sh DESCRIPTION The .Tn Linux system file system, or .Nm , emulates a subset of the .Tn Linux sys file system and is required for the complete operation of some .Tn Linux binaries. .Pp The .Nm provides a two-level view of devices. At the highest level, PCI devices themselves are named, according to their bus, slot and function in the system hierarchy. PCI storage devices are listed in the .Pa scsi_host class with a device symlink to the PCI directories of the devices. .Pp Each device node is a directory containing some files and directories: .Bl -tag -width ".Pa status" .It Pa host A place holder for storage host information. .It Pa pci_id A directory for the .Pa pci_id that contains either the device information or another directory structure for a PCI bridge. .El .Pp Each host node of scsi_host is a directory containing some files and directories: .Bl -tag -width ".Pa proc_name" .It Pa proc_name The .Tn Linux registered driver name for these devices. .It Pa device A symlink to the PCI device directory. .El .Sh FILES .Bl -tag -width ".Pa /compat/linux/sys/devices/pci0000:00" -compact .It Pa /compat/linux/sys The normal mount point for .Nm . .It Pa /compat/linux/sys/class/scsi_host The storage host node. .It Pa /compat/linux/sys/devices/pci0000:00 The PCI device hierarchy node. .El .Sh EXAMPLES The most common usage follows: .Pp .Dl "mount -t linsysfs linsys /compat/linux/sys" .Pp where .Pa /compat/linux/sys is a mount point. .Sh SEE ALSO .Xr nmount 2 , .Xr unmount 2 , .Xr linux 4 , .Xr linprocfs 5 , .Xr pseudofs 9 .Sh HISTORY The .Nm driver first appeared in .Fx 6.2 . .Sh AUTHORS .An -nosplit The .Nm driver was derived from .Nm linprocfs by .An Doug Ambrisko . This manual page was edited by .An Doug Ambrisko , based on the .Xr linprocfs 5 manual page by .An Garrett Wollman . diff --git a/share/man/man5/mqueuefs.5 b/share/man/man4/mqueuefs.4 similarity index 99% rename from share/man/man5/mqueuefs.5 rename to share/man/man4/mqueuefs.4 index 7be49a816968..384a3e3e6546 100644 --- a/share/man/man5/mqueuefs.5 +++ b/share/man/man4/mqueuefs.4 @@ -1,122 +1,122 @@ .\" Copyright (c) 2005 David Xu .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice(s), this list of conditions and the following disclaimer as .\" the first lines of this file unmodified other than the possible .\" addition of one or more copyright notices. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice(s), this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (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 November 30, 2005 -.Dt MQUEUEFS 5 +.Dt MQUEUEFS 4 .Os .Sh NAME .Nm mqueuefs .Nd POSIX message queue file system .Sh SYNOPSIS To link into kernel: .Pp .Cd "options P1003_1B_MQUEUE" .Pp To load as a kernel loadable module: .Pp .Dl "kldload mqueuefs" .Sh DESCRIPTION The .Nm module will permit the .Fx kernel to support .Tn POSIX message queue. The module contains system calls to manipulate .Tn POSIX message queues. It also contains a file system to implement a view for all message queues of the system. This helps users to keep track of their message queues and make it more easily usable without having to invent additional tools. .Pp The most common usage is as follows: .Pp .Dl "mount -t mqueuefs null /mnt/mqueue" .Pp where .Pa /mnt/mqueue is a mount point. .Pp It is possible to define an entry in .Pa /etc/fstab that looks similar to: .Bd -literal null /mnt/mqueue mqueuefs rw 0 0 .Ed .Pp This will mount .Nm at the .Pa /mnt/mqueue mount point during system boot. Using .Pa /mnt/mqueue as a permanent mount point is not advised as its intention has always been to be a temporary mount point. See .Xr hier 7 for more information on .Fx directory layout. .Pp Some common tools can be used on the file system, e.g.: .Xr cat 1 , .Xr chmod 1 , .Xr chown 8 , .Xr ls 1 , .Xr rm 1 , etc. To use only the message queue system calls, it is not necessary for user to mount the file system, just load the module or compile it into the kernel. Manually creating a file, for example, .Dq Li "touch /mnt/mqueue/myqueue" , will create a message queue named .Pa myqueue in the kernel, default message queue attributes will be applied to the queue. It is not advised to use this method to create a queue; it is better to use the .Xr mq_open 2 system call to create a queue as it allows the user to specify different attributes. .Pp To see the queue's attributes, just read the file: .Pp .Dl "cat /mnt/mqueue/myqueue" .Sh SEE ALSO .Xr mq_open 2 , .Xr nmount 2 , .Xr unmount 2 , .Xr mount 8 , .Xr umount 8 .Sh AUTHORS This manual page was written by .An David Xu Aq Mt davidxu@FreeBSD.org . diff --git a/share/man/man5/msdosfs.5 b/share/man/man4/msdosfs.4 similarity index 99% rename from share/man/man5/msdosfs.5 rename to share/man/man4/msdosfs.4 index 2856b4b5cc82..df937311060b 100644 --- a/share/man/man5/msdosfs.5 +++ b/share/man/man4/msdosfs.4 @@ -1,73 +1,73 @@ .\" Written by Tom Rhodes .\" This file is in the public domain. .\" .Dd September 27, 2018 -.Dt MSDOSFS 5 +.Dt MSDOSFS 4 .Os .Sh NAME .Nm msdosfs .Nd MS-DOS file system .Sh SYNOPSIS .Cd "options MSDOSFS" .Sh DESCRIPTION The .Nm driver will permit the .Fx kernel to read and write MS-DOS based file systems. .Pp The most common usage follows: .Pp .Dl "mount -t msdosfs /dev/ada0sN /mnt" .Pp where .Ar N is the partition number and .Pa /mnt is a mount point. Some users tend to create a .Pa /dos directory for .Nm mount points. This helps to keep better track of the file system, and make it more easily accessible. .Pp It is possible to define an entry in .Pa /etc/fstab that looks similar to: .Bd -literal /dev/ada0sN /dos msdosfs rw 0 0 .Ed .Pp This will mount an MS-DOS based partition at the .Pa /dos mount point during system boot. Using .Pa /mnt as a permanent mount point is not advised as its intention has always been to be a temporary mount point for floppy and ZIP disks. See .Xr hier 7 for more information on .Fx directory layout. .Sh EXAMPLES Determine which FAT file system version (e.g, FAT16, FAT32) is a partition formatted with: .Bd -literal -offset indent file -s /dev/da0s1 .Ed .Pp .Xr gpart 8 may also be used to extract this information. .Sh SEE ALSO .Xr mount 2 , .Xr unmount 2 , .Xr mount 8 , .Xr mount_msdosfs 8 , .Xr umount 8 .Sh AUTHORS This manual page was written by .An Tom Rhodes Aq Mt trhodes@FreeBSD.org . diff --git a/share/man/man5/nullfs.5 b/share/man/man4/nullfs.4 similarity index 99% rename from share/man/man5/nullfs.5 rename to share/man/man4/nullfs.4 index 6e2c199aa3b0..5aca03071594 100644 --- a/share/man/man5/nullfs.5 +++ b/share/man/man4/nullfs.4 @@ -1,80 +1,80 @@ .\" .\" Copyright (c) 2008 Daniel Gerzo .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (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 March 15, 2022 -.Dt NULLFS 5 +.Dt NULLFS 4 .Os .Sh NAME .Nm nullfs .Nd "null file system" .Sh SYNOPSIS To enable support for this driver, place the following line in the kernel configuration file: .Bd -ragged -offset indent .Cd "options NULLFS" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent nullfs_load="YES" .Ed .Sh DESCRIPTION The .Nm driver will permit the .Fx kernel to mount a loopback file system sub-tree. .Sh EXAMPLES To mount a .Nm file system: .Pp .Dl "mount_nullfs /usr/ports /home/devel/ports" .Pp It is also possible to define an entry in .Xr fstab 5 that looks similar to: .Pp .Bd -literal /usr/ports /home/devel/ports nullfs rw 0 0 .Ed .Sh SEE ALSO .Xr fstab 5 , .Xr mount_nullfs 8 .Sh HISTORY The .Nm layer first appeared in .Bx 4.4 . .Sh AUTHORS .An -nosplit The .Nm kernel implementation was written by .An John Heideman . .Pp This manual page was written by .An Daniel Gerzo Aq Mt danger@FreeBSD.org . diff --git a/share/man/man5/procfs.5 b/share/man/man4/procfs.4 similarity index 99% rename from share/man/man5/procfs.5 rename to share/man/man4/procfs.4 index 5977a8bced81..64dd3100e6bc 100644 --- a/share/man/man5/procfs.5 +++ b/share/man/man4/procfs.4 @@ -1,308 +1,308 @@ .\" Written by Garrett Wollman .\" This file is in the public domain. .\" .Dd April 10, 2023 -.Dt PROCFS 5 +.Dt PROCFS 4 .Os .Sh NAME .Nm procfs .Nd process file system .Sh SYNOPSIS .Bd -literal proc /proc procfs rw 0 0 .Ed .Sh DESCRIPTION .Bf -symbolic This functionality is deprecated. Users are advised to use .Xr libprocstat 3 and .Xr kvm 3 instead. .Ef .Pp The process file system, or .Nm , implements a view of the system process table inside the file system. It is normally mounted on .Pa /proc . .Pp The .Nm provides a two-level view of process space, unlike the previous .Fx 1.1 .Nm implementation. At the highest level, processes themselves are named, according to their process ids in decimal, with no leading zeros. There is also a special node called .Pa curproc which always refers to the process making the lookup request. .Pp Each node is a directory which contains the following entries: .Bl -tag -width status .It Pa dbregs The debug registers as defined by .Dv "struct dbregs" in .In machine/reg.h . .Pa dbregs is currently only implemented on the i386 architecture. .It Pa etype The type of the executable referenced by the .Pa file entry. .It Pa file A symbolic link to the file from which the process text was read. This can be used to gain access to the process' symbol table, or to start another copy of the process. If the file cannot be found, the link target is .Ql unknown . .It Pa fpregs The floating point registers as defined by .Dv "struct fpregs" in .In machine/reg.h . .Pa fpregs is only implemented on machines which have distinct general purpose and floating point register sets. .It Pa map A collection of lines describing the memory regions of the process, where each line contains the following fields: .Bl -tag -compact -width private-resident .It start-address The starting address for the region (inclusive). .It end-address The ending address for the region (exclusive). .It resident The number of resident pages. .It private-resident The number of resident pages that were private to the process. .It obj The virtual address of the .Vt struct vm_object kernel data structure describing the memory region. .It access A three character string comprising the characters .Sq r , .Sq w and .Sq x , denoting read, write, and execute permissions respectively. The lack of a permission is represented by .Sq - . .It ref_count The number of references to the region. .It shadow_count The number of VM objects that this region is a shadow for. .It flags The flags for the object, see the flags named .Sy OBJ_* in .In vm/vm_object.h . .It copy-on-write Whether the region is copy-on-write. One of: .Bl -tag -compact -width NCOW .It COW A copy-on-write region. .It NCOW A non-copy-on-write region. .El .It needs-copy Whether the region needs a copy. One of: .Bl -tag -compact -width NNC .It NC The region needs a copy. .It NNC The region does not need a copy. .El .It type The type of the region. One of: .Bl -tag -compact -width unknown .It dead A region associated with a dead VM object. .It device A region backed by device memory. .It none A region not backed by anything. .It phys A region backed by physical memory. .It swap A region backed by swap. .It unknown A region of unknown type. .It vnode A region backed by a file. .El .It fullpath The path to the file backing the memory region, or .Sq - if there is no such file. .It cred One of: .Bl -tag -compact -width NCH .It CH The region is being charged to the user specified in the .Sq charged-uid field. .It NCH The region is not being charged to any user. .El .It charged-uid The UID of the user being charged, or -1 if no user is being charged. .El .It Pa mem The complete virtual memory image of the process. Only those address which exist in the process can be accessed. Reads and writes to this file modify the process. Writes to the text segment remain private to the process. .It Pa note Used for sending signals to the process. Not implemented. .It Pa notepg Used for sending signal to the process group. Not implemented. .It Pa osrel Allows read and write of the kernel osrel value assigned to the process. It affects the compatibility shims that are turned on and off depending on the value. Initial process value is read from the ABI note tag in the executed ELF image, and is zero if the tag not supported by binary format or was not found. .It Pa regs Allows read and write access to the process' register set. This file contains a binary data structure .Dv "struct regs" defined in .In machine/reg.h . .Pa regs can only be written when the process is stopped. .It Pa rlimit This is a read-only file containing the process current and maximum limits. Each line is of the format .Ar rlimit current max , with -1 indicating infinity. .It Pa status The process status. This file is read-only and returns a single line containing multiple space-separated fields as follows: .Pp .Bl -bullet -compact .It command name .It process id .It parent process id .It process group id .It session id .It device name of the controlling terminal, or a minus sign .Pq Dq - if there is no controlling terminal. .It a list of process flags: .Dv ctty if there is a controlling terminal, .Dv sldr if the process is a session leader, .Dv noflags if neither of the other two flags are set. .It the process start time in seconds and microseconds, comma separated. .It the user time in seconds and microseconds, comma separated. .It the system time in seconds and microseconds, comma separated. .It the wait channel message .It the process credentials consisting of the effective user id and the list of groups (whose first member is the effective group id) all comma separated. .It the hostname of the jail in which the process runs, or .Ql - to indicate that the process is not running within a jail. .El .El .Pp Each node is owned by the process's user, and belongs to that user's primary group. .Sh FILES .Bl -tag -width /proc/curproc/XXXXXXX -compact .It Pa /proc normal mount point for the .Nm . .It Pa /proc/pid directory containing process information for process .Pa pid . .It Pa /proc/curproc directory containing process information for the current process .It Pa /proc/self directory containing process information for the current process .It Pa /proc/curproc/cmdline the process executable name .It Pa /proc/curproc/etype executable type .It Pa /proc/curproc/exe executable image .It Pa /proc/curproc/file executable image .It Pa /proc/curproc/fpregs the process floating point register set .It Pa /proc/curproc/map virtual memory map of the process .It Pa /proc/curproc/mem the complete virtual address space of the process .It Pa /proc/curproc/note used for signaling the process .It Pa /proc/curproc/notepg used for signaling the process group .It Pa /proc/curproc/osrel the process osrel value .It Pa /proc/curproc/regs the process register set .It Pa /proc/curproc/rlimit the process current and maximum rlimit .It Pa /proc/curproc/status the process' current status .El .Sh EXAMPLES To mount a .Nm file system on .Pa /proc : .Pp .Dl "mount -t procfs proc /proc" .Sh SEE ALSO .Xr procstat 1 , .Xr mount 2 , .Xr sigaction 2 , .Xr unmount 2 , .Xr kvm 3 , .Xr libprocstat 3 , .Xr pseudofs 9 .Sh AUTHORS .An -nosplit This manual page written by .An Garrett Wollman , based on the description provided by .An Jan-Simon Pendry , and revamped later by .An Mike Pritchard . diff --git a/share/man/man5/smbfs.5 b/share/man/man4/smbfs.4 similarity index 99% rename from share/man/man5/smbfs.5 rename to share/man/man4/smbfs.4 index 7be90c3ba882..c0650b8e17d6 100644 --- a/share/man/man5/smbfs.5 +++ b/share/man/man4/smbfs.4 @@ -1,96 +1,96 @@ .\" Copyright (c) 2020 Gordon Bergling .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 6, 2022 -.Dt SMBFS 5 +.Dt SMBFS 4 .Os .Sh NAME .Nm smbfs .Nd "SMB FS" .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "option NETSMB" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent smbfs_load="YES" .Ed .Sh DESCRIPTION The SMB driver is an implementation of the CIFS (Common Internet Filesystem) network protocol. .Pp .Bf -symbolic The .Nm filesystem driver supports only the obsolete SMBv1 protocol. .Nm has known bugs and likely has security vulnerabilities. .Nm and userspace counterparts .Xr smbutil 1 and .Xr mount_smbfs 8 may be removed from a future version of .Fx . Users are advised to evaluate the .Pa sysutils/fusefs-smbnetfs port instead. .Ef .Sh SEE ALSO .Xr smbutil 1 , .Xr mount_smbfs 8 .Sh STANDARDS .Rs .%U https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-cifs/ .%T Common Internet File System (CIFS) Protocol .%R MS-CIFS .%D December 2018 .Re .Pp .Rs .%U https://tools.ietf.org/html/draft-heizer-cifs-v1-spec-00 .%T Common Internet File System Protocol (CIFS/1.0) .%D June 13, 1996 .%A I. Heizer .%A P. Leach .%A D. Perry .Re .Sh HISTORY The .Nm device driver first appeared in .Fx 4.4 . .Sh AUTHORS .An -nosplit The .Nm device driver was written by .An Boris Popov Aq Mt bp@FreeBSD.org . The manual page was contributed by .An Gordon Bergling Aq Mt gbe@FreeBSD.org . diff --git a/share/man/man5/tarfs.5 b/share/man/man4/tarfs.4 similarity index 100% rename from share/man/man5/tarfs.5 rename to share/man/man4/tarfs.4 diff --git a/share/man/man5/tmpfs.5 b/share/man/man4/tmpfs.4 similarity index 99% rename from share/man/man5/tmpfs.5 rename to share/man/man4/tmpfs.4 index f3d6a2f6c2b5..ce6b23e3ae7b 100644 --- a/share/man/man5/tmpfs.5 +++ b/share/man/man4/tmpfs.4 @@ -1,229 +1,229 @@ .\"- .\" Copyright (c) 2007 Xin LI .\" Copyright (c) 2017 The FreeBSD Foundation, Inc. .\" .\" Part of this documentation was written by .\" Konstantin Belousov under sponsorship .\" from the FreeBSD Foundation. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\"- .\" Copyright (c) 2005, 2006 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN .\" CONTRACT, STRICT LIABILITY, OR TORT (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 September 18, 2023 -.Dt TMPFS 5 +.Dt TMPFS 4 .Os .Sh NAME .Nm tmpfs .Nd "in-memory file system" .Sh SYNOPSIS To compile this driver into the kernel, place the following line in your kernel configuration file: .Bd -ragged -offset indent .Cd "options TMPFS" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent tmpfs_load="YES" .Ed .Sh DESCRIPTION The .Nm driver implements an in-memory, or .Nm file system. The filesystem stores both file metadata and data in main memory. This allows very fast and low latency accesses to the data. The data is volatile. An umount or system reboot invalidates it. These properties make the filesystem's mounts suitable for fast scratch storage, like .Pa /tmp . .Pp If the system becomes low on memory and swap is configured .Po see .Xr swapon 8 Pc , the system can transfer file data to swap space, freeing memory for other needs. Metadata, including the directory content, is never swapped out by the current implementation. Keep this in mind when planning the mount limits, especially when expecting to place many small files on a tmpfs mount. .Pp When .Xr mmap 2 is used on a file from a tmpfs mount, the swap VM object managing the file pages is used to implement mapping and avoid double-copying of the file data. This quirk causes process inspection tools, like .Xr procstat 1 , to report anonymous memory mappings instead of file mappings. .Sh OPTIONS The following options are available when mounting .Nm file systems: .Bl -tag -width "maxfilesize" .It Cm easize Set the maximum memory size used by extended attributes in bytes. The default is 16 megabytes. .It Cm export Accept the .Cm export option for compatibility with .Xr nfsv4 4 . This option does nothing. .It Cm gid Set the group ID of the root inode of the file system. The default is the mount point's GID. .It Cm inodes Set the maximum number of nodes available to the file system. If not specified, the file system chooses a reasonable maximum based on the file system size, which can be limited with the .Cm size option. .It Cm maxfilesize Set the maximum file size in bytes. The default is the maximum possible value. .It Cm mode Set the mode (in octal notation) of the root inode of the file system. The default is the mount point's mode. .It Cm nomtime Disable the tracking of mtime updates caused by writes to the shared mapped areas backed by .Nm files. This option removes periodic scans, which downgrade read-write-mapped pages to read-only to note the writes. .It Cm nonc Do not use namecache to resolve names to files for the created mount. This saves memory, but currently might impair scalability for highly used mounts on large machines. .It Cm nosymfollow Do not follow .Xr symlink 7 Ap s on the mounted file system. .It Cm pgread Enable pgcache read for the mount. .It Cm size Set the total file system size in bytes, unless suffixed with one of k, m, g, t, or p, which denote byte, kilobyte, megabyte, gigabyte, terabyte and petabyte respectively. If zero (the default) or a value larger than SIZE_MAX - PAGE_SIZE is given, the available amount of memory (including main memory and swap space) will be used. .It Cm uid Set the user ID of the root inode of the file system. The default is the mount point's UID. .It Cm union Refer to .Xr mount 8 . .El .Sh SYSCTL VARIABLES The following .Xr sysctl 8 variables are available: .Bl -tag -width indent .It Va vfs.tmpfs.memory_percent The percentage of memory plus swap space available at kernel file system initialization that can be used by a file system with a size of 0. When this amount of space in use is reached, new files cannot be created and files cannot be extended. The default is 95%. Changing this value also changes .Va vfs.tmpfs.memory_reserved . .It Va vfs.tmpfs.memory_reserved The currently-reserved amount of memory plus swap space based on the memory percentage. The minimum is compiled into the system, and defaults to 4 MB. .El .Sh EXAMPLES Mount a .Nm memory file system: .Pp .Dl "mount -t tmpfs tmpfs /tmp" .Pp Configure a .Nm mount via .Xr fstab 5 : .Bd -literal -offset indent tmpfs /tmp tmpfs rw 0 0 .Ed .Sh SEE ALSO .Xr procstat 1 , .Xr mmap 2 , .Xr nmount 2 , .Xr unmount 2 , .Xr fstab 5 , .Xr mdmfs 8 , .Xr mount 8 , .Xr swapinfo 8 , .Xr swapon 8 .Sh HISTORY The .Nm driver first appeared in .Fx 7.0 . .Sh AUTHORS .An -nosplit The .Nm kernel implementation was written by .An Julio M. Merino Vidal Aq Mt jmmv@NetBSD.org as a Google Summer of Code project. .Pp .An Rohit Jalan and others ported it from .Nx to .Fx . .Pp This manual page was written by .An Xin LI Aq Mt delphij@FreeBSD.org . diff --git a/share/man/man5/unionfs.5 b/share/man/man4/unionfs.4 similarity index 99% rename from share/man/man5/unionfs.5 rename to share/man/man4/unionfs.4 index a20889d54839..205958def903 100644 --- a/share/man/man5/unionfs.5 +++ b/share/man/man4/unionfs.4 @@ -1,86 +1,86 @@ .\" Copyright (c) 2020 Gordon Bergling .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 27, 2020 -.Dt UNIONFS 5 +.Dt UNIONFS 4 .Os .Sh NAME .Nm unionfs .Nd "UNION FS" .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "option UNIONFS" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent unionfs_load="YES" .Ed .Sh DESCRIPTION The UNIONFS driver is an implementation of a stackable unification filesystem. .Sh SEE ALSO .Xr mount_unionfs 8 .Sh STANDARDS .Rs .%T Union mounts in 4.4BSD-Lite .%A J. S. Pendry .%A M. K. McKusick .%R Proceedings of the USENIX Technical Conference on UNIX and Advanced Computing Systems .%D December 1995 .Re .Pp .Rs .%T Jails: Confining the omnipotent root .%A P. H. Kamp .%A R. N. M. Watson .%R Proceedings of the Second International System Administration and Networking Conference (SANE2000) .%D May 2000 .Re .Sh HISTORY The .Nm device driver first appeared in .Fx 5.0 . .Sh AUTHORS .An -nosplit The .Nm device driver was written by Jan-Simon Pendry for .Bx 4.4 and .An Masanori OZAWA Aq Mt ozawa@ongs.co.jp reimplemented the handling of the locking for .Fx 7.0 . The manual page was written by .An Gordon Bergling Aq Mt gbe@FreeBSD.org . .Sh BUGS Please see the .Xr mount_unionfs 8 manual page for a list of bugs regarding the .Nm filesystem. diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile index d9129307bea2..bc345b42717c 100644 --- a/share/man/man5/Makefile +++ b/share/man/man5/Makefile @@ -1,115 +1,93 @@ .include #MISSING: dump.5 plot.5 MAN= acct.5 \ ar.5 \ a.out.5 \ ${_boot.config.5} \ - cd9660.5 \ core.5 \ - devfs.5 \ devfs.conf.5 \ devfs.rules.5 \ device.hints.5 \ dir.5 \ disktab.5 \ elf.5 \ ethers.5 \ eui64.5 \ - ext2fs.5 \ fbtab.5 \ - fdescfs.5 \ forward.5 \ fs.5 \ fstab.5 \ - fusefs.5 \ group.5 \ hosts.5 \ hosts.equiv.5 \ hosts.lpd.5 \ intro.5 \ libmap.conf.5 \ - lindebugfs.5 \ link.5 \ - linprocfs.5 \ - linsysfs.5 \ mailer.conf.5 \ make.conf.5 \ moduli.5 \ motd.5 \ mount.conf.5 \ - mqueuefs.5 \ - msdosfs.5 \ networks.5 \ nsmb.conf.5 \ nsswitch.conf.5 \ - nullfs.5 \ os-release.5 \ passwd.5 \ pbm.5 \ periodic.conf.5 \ phones.5 \ portindex.5 \ - procfs.5 \ protocols.5 \ quota.user.5 \ rc.conf.5 \ rctl.conf.5 \ regdomain.5 \ remote.5 \ resolver.5 \ services.5 \ shells.5 \ - smbfs.5 \ src.conf.5 \ stab.5 \ style.Makefile.5 \ style.mdoc.5 \ sysctl.conf.5 \ - tarfs.5 \ - tmpfs.5 \ - unionfs.5 MLINKS= dir.5 dirent.5 -MLINKS+=ext2fs.5 ext4fs.5 MLINKS+=fs.5 inode.5 MLINKS+=hosts.equiv.5 rhosts.5 -MLINKS+=msdosfs.5 msdos.5 MLINKS+=passwd.5 master.passwd.5 MLINKS+=passwd.5 pwd.db.5 MLINKS+=passwd.5 spwd.db.5 MLINKS+=portindex.5 INDEX.5 MLINKS+=quota.user.5 quota.group.5 MLINKS+=rc.conf.5 rc.conf.local.5 MLINKS+=resolver.5 resolv.conf.5 MLINKS+=src.conf.5 src-env.conf.5 -.if ${MK_AUTOFS} != "no" -MAN+= autofs.5 -.endif - .if ${MK_BLUETOOTH} != "no" MAN+= bluetooth.device.conf.5 \ bluetooth.hosts.5 \ bluetooth.protocols.5 .endif .if ${MK_FREEBSD_UPDATE} != "no" MAN+= freebsd-update.conf.5 .endif .if ${MK_HESIOD} != "no" MAN+= hesiod.conf.5 .endif .if ${MK_PF} != "no" MAN+= pf.conf.5 \ pf.os.5 .endif # This makes more sense for amd64 and i386 but # we decide to install all manpages in all architectures _boot.config.5= boot.config.5 .include diff --git a/share/man/man7/Makefile b/share/man/man7/Makefile index f163d4e0a0d8..b83399b2917d 100644 --- a/share/man/man7/Makefile +++ b/share/man/man7/Makefile @@ -1,65 +1,64 @@ .include #MISSING: eqnchar.7 ms.7 term.7 MAN= arch.7 \ ascii.7 \ bsd.snmpmod.mk.7 \ build.7 \ c.7 \ clocks.7 \ crypto.7 \ development.7 \ environ.7 \ - ffs.7 \ firewall.7 \ growfs.7 \ hier.7 \ hostname.7 \ intro.7 \ maclabel.7 \ mitigations.7 \ operator.7 \ orders.7 \ ports.7 \ release.7 \ sdoc.7 \ security.7 \ simd.7 \ sizeof.7 \ sprog.7 \ stats.7 \ stdint.7 \ sticky.7 \ tests.7 \ tuning.7 MLINKS= intro.7 miscellaneous.7 MLINKS+= growfs.7 growfs_fstab.7 MLINKS+= security.7 securelevel.7 MLINKS+= c.7 c78.7 MLINKS+= c.7 c89.7 MLINKS+= c.7 c90.7 MLINKS+= c.7 c95.7 MLINKS+= c.7 c99.7 MLINKS+= c.7 c11.7 MLINKS+= c.7 c17.7 MLINKS+= c.7 c2x.7 .if ${MK_INET} != "no" MAN+= networking.7 MLINKS+= networking.7 wifi.7 .endif .if ${MK_TESTS} != "no" ATF= ${SRCTOP}/contrib/atf .PATH: ${ATF}/doc MAN+= atf.7 CLEANFILES+= atf.7 atf.7: atf.7.in sed -e 's,__DOCDIR__,/usr/share/doc/atf,g' \ <"${ATF}/doc/atf.7.in" >atf.7 .endif .include diff --git a/share/man/man7/intro.7 b/share/man/man7/intro.7 index a155839bde64..be6f68556895 100644 --- a/share/man/man7/intro.7 +++ b/share/man/man7/intro.7 @@ -1,104 +1,101 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (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 18, 2024 .Dt INTRO 7 .Os .Sh NAME .Nm intro .Nd miscellaneous information pages .Sh DESCRIPTION This section contains miscellaneous documentation. .Bl -tag -width "mdoc.samples(7)" -offset indent .It Xr arch 7 supported CPU architectures and platforms .It Xr ascii 7 map of ASCII character set .It Xr build 7 build instructions for .Fx .It Xr c 7 the C programming language .It Xr clocks 7 system timekeeping clocks available in .Fx .It Xr crypto 7 cryptographic algorithms provided by OpenCrypto in .Fx .It Xr development 7 development introduction to .Fx .It Xr environ 7 user environment -.It Xr ffs 7 -commonly used filesystem in -.Fx .It Xr firewall 7 simple firewalls under .Fx .It Xr hier 7 file system hierarchy in .Fx .It Xr hostname 7 host name resolution description .It Xr networking 7 network connection quickstart guide .It Xr release 7 layout of .Fx releases and snapshots .It Xr ports 7 introduction to the ports infrastructure of .Fx .It Xr security 7 security features available in .Fx .It Xr stats 7 statistics utilities available in .Fx .It Xr tests 7 introduction to the .Fx Test Suite .It Xr tuning 7 general advice on tuning .Fx .El .Sh SEE ALSO .Xr man 1 , .Xr intro 2 , .Xr intro 3 , .Xr intro 4 , .Xr intro 5 , .Xr intro 6 , .Xr intro 8 , .Xr intro 9 .Sh HISTORY The .Nm section manual page appeared in .Bx 4.2 .