public inbox for cygwin-announce@cygwin.com
 help / color / mirror / Atom feed
From: "Cygwin Linux Man Pages Maintainer" <Brian.Inglis@SystematicSW.ab.ca>
To: "Cygwin Announcements" <cygwin-announce@cygwin.com>
Subject: Updated: man-pages-linux 6.06
Date: Sat, 17 Feb 2024 10:43:57 -0700	[thread overview]
Message-ID: <20240217104357.4960-1-Brian.Inglis@SystematicSW.ab.ca> (raw)

The following package has been upgraded in the Cygwin distribution:

* man-pages-linux	6.06

Documents the Linux kernel system calls and C library interfaces used
by programs, plus system and administrative utilities, devices, file
system, file, and data formats, and related information.

For more information, see the project home page:

	https://kernel.org/doc/man-pages/

As Cygwin has its own man pages with some conflicts, these man pages are
installed under /usr/share/man/man-pages-linux/, so by default searching
or viewing these pages requires the option:

	$ apropos -m|--systems man-pages-linux ...
	$ man -m|--systems man-pages-linux ...

Cygwin man pages are under the default system "man", so for convenience
both systems may be specified separated by comma e.g.

	$ man -m man,man-pages-linux ...

The path or option may also be added explicitly to a users MANPATH or
alias e.g.

	$ export MANPATH=$MANPATH:/usr/share/man/man-pages-linux

	$ alias apropos='apropos -m man,man-pages-linux'
	$ alias man='man -m man,man-pages-linux'

Add -a to show both Cygwin and Linux (and POSIX if companion package
man-pages-posix is also installed) manual pages.

For convenience and backward compatibility /usr/share/man/linux is
provided as a symlink. 

If you prefer to see Linux man pages over Cygwin man pages, then use
-m|--systems linux in the examples above, or add -m linux to a command.

Release 6 added some section 2 and 3 pages suffixed by const, head,
or type installed in the base section directories.

For recent changes, please see below, or after installation read
/usr/share/doc/man-pages-linux/Changes:


man-pages	6.06	2024-02-12

New and rewritten pages
-----------------------

man2/
	ioctl_pagemap_scan.2

man3/					(taken from glibc's linuxthreads)
	pthread_cond_init.3
	pthread_condattr_init.3
	pthread_key_create.3
	pthread_mutex_init.3
	pthread_mutexattr_setkind_np.3
	pthread_once.3

man5/
	proc.5				(split into many small pages)
	proc_apm.5
	proc_buddyinfo.5
	proc_bus.5
	proc_cgroups.5
	proc_cmdline.5
	proc_config.gz.5
	proc_cpuinfo.5
	proc_crypto.5
	proc_devices.5
	proc_diskstats.5
	proc_dma.5
	proc_driver.5
	proc_execdomains.5
	proc_fb.5
	proc_filesystems.5
	proc_fs.5
	proc_ide.5
	proc_interrupts.5
	proc_iomem.5
	proc_ioports.5
	proc_kallsyms.5
	proc_kcore.5
	proc_key-users.5
	proc_keys.5
	proc_kmsg.5
	proc_kpagecgroup.5
	proc_kpagecount.5
	proc_kpageflags.5
	proc_ksyms.5
	proc_loadavg.5
	proc_locks.5
	proc_malloc.5
	proc_meminfo.5
	proc_modules.5
	proc_mtrr.5
	proc_partitions.5
	proc_pci.5
	proc_pid.5
	proc_pid_attr.5
	proc_pid_autogroup.5
	proc_pid_auxv.5
	proc_pid_cgroup.5
	proc_pid_clear_refs.5
	proc_pid_cmdline.5
	proc_pid_comm.5
	proc_pid_coredump_filter.5
	proc_pid_cpuset.5
	proc_pid_cwd.5
	proc_pid_environ.5
	proc_pid_exe.5
	proc_pid_fd.5
	proc_pid_fdinfo.5
	proc_pid_io.5
	proc_pid_limits.5
	proc_pid_map_files.5
	proc_pid_maps.5
	proc_pid_mem.5
	proc_pid_mountinfo.5
	proc_pid_mounts.5
	proc_pid_mountstats.5
	proc_pid_net.5
	proc_pid_ns.5
	proc_pid_numa_maps.5
	proc_pid_oom_score.5
	proc_pid_oom_score_adj.5
	proc_pid_pagemap.5
	proc_pid_personality.5
	proc_pid_projid_map.5
	proc_pid_root.5
	proc_pid_seccomp.5
	proc_pid_setgroups.5
	proc_pid_smaps.5
	proc_pid_stack.5
	proc_pid_stat.5
	proc_pid_statm.5
	proc_pid_status.5
	proc_pid_syscall.5
	proc_pid_task.5
	proc_pid_timers.5
	proc_pid_timerslack_ns.5
	proc_pid_uid_map.5
	proc_pid_wchan.5
	proc_profile.5
	proc_scsi.5
	proc_slabinfo.5
	proc_stat.5
	proc_swaps.5
	proc_sys.5
	proc_sys_abi.5
	proc_sys_debug.5
	proc_sys_dev.5
	proc_sys_fs.5
	proc_sys_kernel.5
	proc_sys_net.5
	proc_sys_proc.5
	proc_sys_sunrpc.5
	proc_sys_user.5
	proc_sys_vm.5
	proc_sysrq-trigger.5
	proc_sysvipc.5
	proc_tid_children.5
	proc_timer_list.5
	proc_timer_stats.5
	proc_tty.5
	proc_uptime.5
	proc_version.5
	proc_vmstat.5
	proc_zoneinfo.5


Newly documented interfaces in existing pages
---------------------------------------------

man2/
	access.2
		AT_EMPTY_PATH

	execve.2
		E2BIG

	ioctl_userfaultfd.2
		UFFDIO_API handshake
		UFFDIO_POISON
		UFFD_FEATURE_WP_ASYNC

	mbind.2
		MPOL_F_NUMA_BALANCING

	prctl.2
		PR_SET_MDWE
		PR_GET_MDWE

	set_thread_area.2
		C-SKY

	utimensat.2
		AT_EMPTY_PATH

man3/
	stdio.3
		fmemopen(3)
		fopencookie(3)
		open_memstream(3)
		open_wmemstream(3)

man4/
	smartpqi.4
		ctrl_ready_timeout
		enable_stream_detection
		ssd_smart_path_enabled
		enable_r5_writes
		enable_r6_writes
		lunid
		unique_id
		path_info
		raid_bypass_cnt
		sas_ncq_prio_enable

man5/
	proc_pid_status.5		(previously, proc.5)
		Seccomp_filters

	tmpfs.5
		size/blocks=0
		nr_inodes=0

man8/
	ld.so.8
		--list-diagnostics
		--glibc-hwcaps-mask
		--glibc-hwcaps-prepend


New and changed links
---------------------

man5/
	proc_mounts.5			(proc_pid_mounts(5))
	proc_net.5			(proc_pid_net(5))
	proc_pid_gid_map.5		(proc_pid_uid_map(5))
	proc_pid_oom_adj.5		(proc_pid_oom_score_adj(5))
	proc_self.5			(proc_pid(5))
	proc_thread-self.5		(proc_pid_task(5))
	proc_tid.5			(proc_pid_task(5))


Removed links
-------------

man3/
	stpecpy.3
	stpecpyx.3
	ustpcpy.3
	ustr2stp.3
	zustr2stp.3
	zustr2ustp.3


Global changes
--------------

-  Build system
   -  Update PDF book for groff-1.23.0.
   -  Add targets to [un]install intro(*) pages separately.
   -  Support manual pages in other projects, so that our build system
      can be used to for example lint them.
   -  Reject non-GNU make(1).
   -  Add target to build the PDF book.

-  man*/
   -  Add some consistency in the use of man(7).
   -  Split proc(5) into many small pages.
   -  Import pages from old linuxthreads (glibc), with their git
      history (from both glibc and Debian).
   -  Rewrite a large part of the documentation for string-copying
      functions.
   -  Say ISO/IEC instead of ISO where appropriate, and be consistent in
      the fomatting of names of ISO or ISO/IEC standards.


Changes to individual pages
---------------------------

The manual pages (and other files in the repository) have been improved
beyond what this changelog covers.  To learn more about changes applied
to individual pages, use git(1).


                 reply	other threads:[~2024-02-17 17:46 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240217104357.4960-1-Brian.Inglis@SystematicSW.ab.ca \
    --to=brian.inglis@systematicsw.ab.ca \
    --cc=cygwin-announce@cygwin.com \
    --cc=cygwin@cygwin.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).