[ITA] acl man pages

Mon Apr 7 11:31:12 GMT 2025

[x-post/f-u to apps]
On 2025年04月01日 08:46, Brian Inglis wrote:
> On 2025年04月01日 02:37, Corinna Vinschen via Cygwin wrote:
>> On Mar 31 23:26, Brian Inglis via Cygwin wrote:
>>> On 2025年03月31日 12:49, Corinna Vinschen via Cygwin wrote:
>>>> On Mar 31 12:35, Brian Inglis via Cygwin wrote:
>>>>> Has anyone a feel if there are any other projects on that list whose man
>>>>> pages would be useful under Cygwin even if the package itself is not
>>>>> available, or even individual man pages where they are not currently
>>>>> available?

>>>> We have quite a few functions which might be only available on BSD systems,
>>>> and we have these Solaris ACL functions which don't exist on Linux.  We
>>>> probably can't use the man pages from Solaris due to copyright constraints,
>>>> but the FreeBSD man pages should be ok.

>>> The Solaris man pages were made available under the CDDL or PDL derived
>>> from MPL: we have Solaris 10 and OpenSolaris 2010 available on the
>>> freebsd.org site, a well as most other OSes anyone might want: 520 of
>>> them, from 7th Edition, 2.10BSD, 386BSD, thru 4.4Lite2, etc.

>> Oh, great.

>>> Space required for FreeBSD man pages is comparable to man-pages-linux -
>>> should we make all FreeBSD 15.0 current man pages available similar to
>>> man-pages-linux - man-pages-freebsd package and directory under
>>> /usr/share/man/ symlinked as freebsd for convenience with man -m|--systems
>>> SYSTEM,...?
>>>>>> Or should we stick to the original idea and package only selected missing
>>> man pages in the other sections of posix.xml as man-pages-extra?

>> Your call.  As long as we don't have dedicated people creating matching
>> man pages for Cygwin (very unlikely for such a small project), we'll
>> never have 100% accurate man pages either way.  So it might be a bit too
>> much hassle to tweak the FreeBSD man pages into a form matching Cygwin.

> The intent would be select from acl, FreeBSD, Solaris, whatever is needed, and 
> not do any tweaking.

> For comparison, I attach lists of acl man pages from acl project, FreeBSD 15, 
> OpenSolaris 2010, and Solaris 10 tars of man pages.

>> The only question is, assuming as a user I have have man-pages-linux
>> and man-pages-freebsd installed.  How do I decide on the command line
>> which of them I see?

> Based on man-pages-linux announcements, for man-pages-freebsd we could say 
> (TL;DR: look at end):
>> "As Cygwin has its own man pages with some overlap, these man pages are
> installed under /usr/share/man/man-pages-freebsd/, so by default searching
> or viewing these pages requires the option:
>>     $ apropos -m|--systems man-pages-freebsd...
>     $ man -m|--systems man-pages-freebsd ...
>> 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-freebsd ...
>> The path or option may also be added explicitly to a user's MANPATH or
> alias e.g.
>>     $ export MANPATH=$MANPATH:/usr/share/man/man-pages-freebsd
>>     $ alias apropos='apropos -m man,man-pages-freebsd'
>     $ alias man='man -m man,man-pages-freebsd'
>> Add -a to show both Cygwin and FreeBSD (and Linux and POSIX if companion 
> packages man-pages-linux and/or man-pages-posix are also installed) manual 
> pages, for example:
>> $ alias man='man -m man,man-pages-freebsd,man-pages-linux,man-pages-posix'
>> where man page display is prioritized by alphabetic directory order of systems, 
> rather than option order (which is explicitly supported for sections selection).
>> For convenience and backward compatibility /usr/share/man/freebsd is
> provided as a symlink.
>> If you prefer to see FreeBSD man pages over Cygwin man pages, then use
> -m|--systems freebsd in the examples above, or add -m freebsd to a man command."

-- 
Take care. Thanks, Brian Inglis Calgary, Alberta, Canada
La perfection est atteinte Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher but when there is no more to cut
 -- Antoine de Saint-Exupéry
-------------- next part --------------
SunOS-5.10/man1as/asadmin-create-acl.1as
SunOS-5.10/man1as/asadmin-delete-acl.1as
SunOS-5.10/man1as/asadmin-list-acls.1as
SunOS-5.10/man1as/create-acl.1as
SunOS-5.10/man1as/delete-acl.1as
SunOS-5.10/man1as/list-acls.1as
SunOS-5.10/man1/getfacl.1
SunOS-5.10/man1/setfacl.1
SunOS-5.10/man2/acl.2
SunOS-5.10/man2/facl.2
SunOS-5.10/man3sec/aclcheck.3sec
SunOS-5.10/man3sec/aclfrommode.3sec
SunOS-5.10/man3sec/aclfromtext.3sec
SunOS-5.10/man3sec/aclsort.3sec
SunOS-5.10/man3sec/acltomode.3sec
SunOS-5.10/man3sec/acltotext.3sec
SunOS-5.10/man4/kadm5.acl.4
SunOS-5.10/sman1as/asadmin-create-acl.1as
SunOS-5.10/sman1as/asadmin-delete-acl.1as
SunOS-5.10/sman1as/asadmin-list-acls.1as
SunOS-5.10/sman1as/create-acl.1as
SunOS-5.10/sman1as/delete-acl.1as
SunOS-5.10/sman1as/list-acls.1as
-------------- next part --------------
OpenSolaris-2010.03-snv_134/share/man/man1/getfacl.1
OpenSolaris-2010.03-snv_134/share/man/man1/setfacl.1
OpenSolaris-2010.03-snv_134/share/man/man2/acl.2
OpenSolaris-2010.03-snv_134/share/man/man2/facl.2
OpenSolaris-2010.03-snv_134/share/man/man3sec/aclcheck.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/aclfrommode.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/aclfromtext.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/aclsort.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acltomode.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acltotext.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_check.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_free.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_fromtext.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_get.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_set.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_strip.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_totext.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_trivial.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/facl_get.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/facl_set.3sec
OpenSolaris-2010.03-snv_134/share/man/man4/kadm5.acl.4
OpenSolaris-2010.03-snv_134/share/man/man5/acl.5
-------------- next part --------------
acl-2.3.2/man/man1/chacl.1
acl-2.3.2/man/man1/getfacl.1
acl-2.3.2/man/man1/setfacl.1
acl-2.3.2/man/man3/acl_add_perm.3
acl-2.3.2/man/man3/acl_calc_mask.3
acl-2.3.2/man/man3/acl_check.3
acl-2.3.2/man/man3/acl_clear_perms.3
acl-2.3.2/man/man3/acl_cmp.3
acl-2.3.2/man/man3/acl_copy_entry.3
acl-2.3.2/man/man3/acl_copy_ext.3
acl-2.3.2/man/man3/acl_copy_int.3
acl-2.3.2/man/man3/acl_create_entry.3
acl-2.3.2/man/man3/acl_delete_def_file.3
acl-2.3.2/man/man3/acl_delete_entry.3
acl-2.3.2/man/man3/acl_delete_perm.3
acl-2.3.2/man/man3/acl_dup.3
acl-2.3.2/man/man3/acl_entries.3
acl-2.3.2/man/man3/acl_equiv_mode.3
acl-2.3.2/man/man3/acl_error.3
acl-2.3.2/man/man3/acl_extended_fd.3
acl-2.3.2/man/man3/acl_extended_file.3
acl-2.3.2/man/man3/acl_extended_file_nofollow.3
acl-2.3.2/man/man3/acl_free.3
acl-2.3.2/man/man3/acl_from_mode.3
acl-2.3.2/man/man3/acl_from_text.3
acl-2.3.2/man/man3/acl_get_entry.3
acl-2.3.2/man/man3/acl_get_fd.3
acl-2.3.2/man/man3/acl_get_file.3
acl-2.3.2/man/man3/acl_get_permset.3
acl-2.3.2/man/man3/acl_get_perm.3
acl-2.3.2/man/man3/acl_get_qualifier.3
acl-2.3.2/man/man3/acl_get_tag_type.3
acl-2.3.2/man/man3/acl_init.3
acl-2.3.2/man/man3/acl_set_fd.3
acl-2.3.2/man/man3/acl_set_file.3
acl-2.3.2/man/man3/acl_set_permset.3
acl-2.3.2/man/man3/acl_set_qualifier.3
acl-2.3.2/man/man3/acl_set_tag_type.3
acl-2.3.2/man/man3/acl_size.3
acl-2.3.2/man/man3/acl_to_any_text.3
acl-2.3.2/man/man3/acl_to_text.3
acl-2.3.2/man/man3/acl_valid.3
acl-2.3.2/man/man5/acl.5
-------------- next part --------------
FreeBSD-15.0-CURRENT/man/man1/getfacl.1.gz
FreeBSD-15.0-CURRENT/man/man1/setfacl.1.gz
FreeBSD-15.0-CURRENT/man/man3/acl.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_add_flag_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_add_perm.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_calc_mask.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_clear_flags_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_clear_perms.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_cmp.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_cmp_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_copy_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_create_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_create_entry_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_def_file.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_def_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_entry_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_fd_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_file_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_flag_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_perm.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_dup.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_equiv_mode_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_extended_file_nofollow_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_extended_file_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_extended_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_free.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_from_mode_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_from_text.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_brand_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_entry_type_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_fd.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_fd_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_file.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_flagset_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_flag_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_permset.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_perm_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_qualifier.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_tag_type.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_init.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_is_trivial_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_entry_type_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_fd.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_fd_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_file.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_flagset_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_permset.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_qualifier.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_tag_type.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_strip_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_to_text.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_to_text_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_valid.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_valid_fd_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_valid_file_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_valid_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_add_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_add_entry_w.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_clear.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_count.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_next.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_next_w.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_reset.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_text_w.3.gz
FreeBSD-15.0-CURRENT/man/man3/krb5_acl_match_file.3.gz
FreeBSD-15.0-CURRENT/man/man3/krb5_acl_match_string.3.gz
FreeBSD-15.0-CURRENT/man/man3/sysdecode_acltype.3.gz
FreeBSD-15.0-CURRENT/man/man4/mac_ipacl.4.gz
FreeBSD-15.0-CURRENT/man/man4/mac_portacl.4.gz
FreeBSD-15.0-CURRENT/man/man4/wlan_acl.4.gz
FreeBSD-15.0-CURRENT/man/man7/maclabel.7.gz
FreeBSD-15.0-CURRENT/man/man9/acl.9.gz
FreeBSD-15.0-CURRENT/man/man9/vaccess_acl_nfs4.9.gz
FreeBSD-15.0-CURRENT/man/man9/vaccess_acl_posix1e.9.gz