Re: git: fbf944ca9ec8 - main - sysutils/fusefs-ntfs: actualize pkg-message.in and README.FreeBSD

From: Fernando_Apesteguía <fernando.apesteguia_at_gmail.com>
Date: Mon, 06 Jun 2022 09:16:50 UTC
El lun., 6 jun. 2022 11:07, Alexey Dokuchaev <danfe@freebsd.org> escribió:

> The branch main has been updated by danfe:
>
> URL:
> https://cgit.FreeBSD.org/ports/commit/?id=fbf944ca9ec8022f5669950cb4ed3233245fa6f1
>
> commit fbf944ca9ec8022f5669950cb4ed3233245fa6f1
> Author:     Alexey Dokuchaev <danfe@FreeBSD.org>
> AuthorDate: 2022-06-06 09:06:08 +0000
> Commit:     Alexey Dokuchaev <danfe@FreeBSD.org>
> CommitDate: 2022-06-06 09:06:08 +0000
>
>     sysutils/fusefs-ntfs: actualize pkg-message.in and README.FreeBSD
>
>     - Mention the necessity of fusefs(5) support in the kernel and
>       how to enable it at the system startup time
>     - Remove outdated URLs and references from the FreeBSD-specific
>       README file; drop the ``Reporting bugs'' section completely as
>       most of it does not reflect modern reality or is simply banal
>
>     PR:     264478, 264479
>

Reported by: Graham Perrin <grahamperrin@gmail.com>

Cheers.

---
>  sysutils/fusefs-ntfs/files/README.FreeBSD | 43
> +++++++------------------------
>  sysutils/fusefs-ntfs/files/pkg-message.in | 11 ++++----
>  2 files changed, 16 insertions(+), 38 deletions(-)
>
> diff --git a/sysutils/fusefs-ntfs/files/README.FreeBSD
> b/sysutils/fusefs-ntfs/files/README.FreeBSD
> index f740ca57854e..ffaedb7707c3 100644
> --- a/sysutils/fusefs-ntfs/files/README.FreeBSD
> +++ b/sysutils/fusefs-ntfs/files/README.FreeBSD
> @@ -7,20 +7,18 @@ NTFS-3G README for the FreeBSD port
>  3. Mounting at startup with /etc/fstab
>  4. Ublio configuration
>  5. Known issues
> -6. Reporting bugs
>
>
>  ==============================================================================
>  1. Introduction
>
>  ==============================================================================
>
>  The NTFS-3G project provides a read/write filesystem driver for NTFS. It
> uses
> -the FUSE library (a OS independent library to create filesystem drivers),
> more
> -precisely FUSE's library with fuse4bsd's kernel module (port of the kernel
> -dependent part of FUSE). For more information see:
> +the FUSE library (an OS-independent library to create filesystem drivers)
> and
> +FreeBSD fusefs(5) kernel module (port of the kernel-dependent part of
> FUSE).
> +For more information see:
>
> -NTFS-3G site:  http://www.tuxera.com/community/ntfs-3g-download/
> -FUSE site:     http://fuse.sourceforge.net/
> -fuse4bsd site: http://fuse4bsd.creo.hu/
> +NTFS-3G site:  https://github.com/tuxera/ntfs-3g
> +FUSE site:     https://github.com/libfuse/libfuse
>
>
>  ==============================================================================
>  2. Port specific notes
> @@ -45,7 +43,9 @@ and reduces disk load.
>
>  To mount at startup you need to have the following line in
> /boot/loader.conf:
>
> -fuse_load="YES"
> +  fusefs_load="YES"
> +
> +or have "fusefs" added to the "kld_list" in the /etc/rc.conf.
>
>  Then create the following symlink:
>
> @@ -120,30 +120,7 @@ operations on different files sometimes the former
> one fails: read(2) returns
>  kernel implementation in Linux and FreeBSD, and is being worked on. An
> example
>  scenario would be playing a song in XMMS, while building many ports, which
>  could cause XMMS skip the song. Another observed problem is the current
> -directory not being found, but entering again would work. The details are
> -described in fuse4bsd (sysutils/fusefs-kmod) documentation (Linux access
> is
> -path based while FreeBSD is vnode based, which may be reused).
> -
>
> -==============================================================================
> -6. Reporting bugs
>
> -==============================================================================
> -
> -About the port itself, you can ask the maintainer (preferable) and/or in
> the
> -ports@FreeBSD.org mailing list.
> -
> -About general NTFS problems (corruptions, etc) ask in the NTFS-3G forum
> (see
> -below).
> -
> -But often (even on Linux, 50% of the issues are related to these) the
> problems
> -reside on the FUSE implementation (the library itself, or fuse4bsd
> portion).
> -
> -For reporting kernel panics, see:
> -
> -http://fuse.sourceforge.net/wiki/index.php/DebugFreeBSDPanicsHowto
> -
> -And you can report them to the fuse4bsd author (preferable), or here:
> -
> -NTFS-3G forum: http://forum.ntfs-3g.org/
> -FreeBSD PRs:   http://www.freebsd.org/send-pr.html
> +directory not being found, but entering again would work (Linux access is
> +path-based while FreeBSD is vnode-based, which may be reused).
>
>
>  ==============================================================================
> diff --git a/sysutils/fusefs-ntfs/files/pkg-message.in
> b/sysutils/fusefs-ntfs/files/pkg-message.in
> index 35df9fe32ec7..dad797469e8e 100644
> --- a/sysutils/fusefs-ntfs/files/pkg-message.in
> +++ b/sysutils/fusefs-ntfs/files/pkg-message.in
> @@ -1,12 +1,13 @@
>  [
>  { type: install
>    message: <<EOM
> -NTFS-3G has been installed, for information, known issues and how to
> report
> -bugs see the FreeBSD README:
> +NTFS-3G has been installed.  It requires fusefs(5) support to operate,
> +so issue the ``kldload fusefs'' command or ``sysrc kld_list+=fusefs''
> +to make it load automatically when the system starts.
>
> -%%DOCSDIR%%/README.FreeBSD
> -
> -Also see the official README (but has some Linux specific parts).
> +For further information, implementation details, and known issues see
> +the FreeBSD README (%%DOCSDIR%%/README.FreeBSD) in
> +addition to the official README (contains some Linux-specific parts).
>  EOM
>  }
>  ]
>