[ANNOUNCEMENT] Updated: man-db-2.10.0-1

[ANNOUNCEMENT] Updated: man-db-2.10.0-1

[Achim Gratz]

The man-db package is updated to the latest upstream version 2.10.0.

Man-db is an implementation of the standard Unix documentation system
accessed using the man command. It uses a Berkeley DB database in place
of the traditional flat-text whatis databases.  This release includes a
performance enhancement that significantly speeds up the creation of the
database.


Cygwin Notes
============

The man-db package includes a conditional perpetual postinstall script
that keeps the database updated each time setup is run if (and only if)
the database exists.  This update now runs in the background by default,
so setup is no longer waiting for the update to complete.  This can be
changed if needed, see below.  The diagnostic output from the update is
stored at /var/log/mandb-index.log, so you can check if there were
problems on the last update.  This release works around a Windows bug
that causes creation of a spurious directory %SystemDrive% in the Cygwin
installation root.

In order to create the database directly via setup, please install the
man-db-create-index package.  The removal of this package will not
remove an existing database, this still needs to be done manually if
required.

If your installation procedure requires that setup waits for the index
update to complete, install the man-db-index-synchronously package
instead.  The creation of a new database can take several minutes to
over an hour depending on how many manual pages are installed and how
fast your filesystem is.  Removal of this package will leave an existing
database in place, but switches the system back to do background
updates.

If you install "everything" that means both the above mentioned helper
packages get installed and the first installation will take a long time
as setup will wait for the newly created index to be complete.


-- 
              *** CYGWIN-ANNOUNCE UNSUBSCRIBE INFO ***

If you want to unsubscribe from the cygwin-announce mailing list, look
at the "List-Unsubscribe: " tag in the email header of this message.
Send email to the address specified there. It will be in the format:

cygwin-announce-unsubscribe-you=yourdomain.com@cygwin.com

If you need more information on unsubscribing, start reading here:

http://sourceware.org/lists.html#unsubscribe-simple

Please read *all* of the information on unsubscribing that is available
starting at this URL.

Re: [ANNOUNCEMENT] Updated: man-db-2.10.0-1

[Andrey Repin]

[-- Attachment #1: Type: text/plain, Size: 1291 bytes --]

Greetings, Achim Gratz!


> The man-db package is updated to the latest upstream version 2.10.0.

> Man-db is an implementation of the standard Unix documentation system
> accessed using the man command. It uses a Berkeley DB database in place
> of the traditional flat-text whatis databases.  This release includes a
> performance enhancement that significantly speeds up the creation of the
> database.

…

> In order to create the database directly via setup, please install the
> man-db-create-index package.

I've checked the database creation out of pure curiosity and it seems there's
more than one issue with the process.

1. Running script from the setup postinstall process causes errors like

/usr/bin/mandb: can't update index cache /var/cache/man/1384: No such file or directory
(the full log attached)

2. Manually forcing database creation with `mandb --create` causes multiple
compilation errors to pop up (log attached)

Errors like
mandb: can't open /usr/share/man/vim.1: No such file or directory
mandb: warning: /usr/share/man/man1/ex.1.gz: bad symlink or ROFF `.so' request

Can somebody help me and explain, what's going on?


-- 
With best regards,
Andrey Repin
Monday, February 7, 2022 21:50:59

Sorry for my terrible english...

[-- Attachment #2: mandb-index.log --]
[-- Type: application/octet-stream, Size: 378 bytes --]

ManDB update started: 2022-02-07T10:11:03+03:00
Purging old database entries in /usr/share/man...
/usr/bin/mandb: can't update index cache /var/cache/man/1384: No such file or directory
Processing manual pages under /usr/share/man...
/usr/bin/mandb: can't create index cache /var/cache/man/1384: Resource temporarily unavailable
ManDB update finished: 2022-02-07T10:11:03+03:00

[-- Attachment #3: mandb-create-index.log.gz --]
[-- Type: application/x-gzip, Size: 1582 bytes --]

Re: [ANNOUNCEMENT] Updated: man-db-2.10.0-1

[Achim Gratz]

Andrey Repin writes:
> I've checked the database creation out of pure curiosity and it seems there's
> more than one issue with the process.
>
> 1. Running script from the setup postinstall process causes errors like
>
> /usr/bin/mandb: can't update index cache /var/cache/man/1384: No such file or directory
> (the full log attached)

Does /var/cache/man exist and are the permissions sane?  I guess I need
to make sure this gets created when installing the package, will note
that for the next release.

> 2. Manually forcing database creation with `mandb --create` causes multiple
> compilation errors to pop up (log attached)
>
> Errors like
> mandb: can't open /usr/share/man/vim.1: No such file or directory
> mandb: warning: /usr/share/man/man1/ex.1.gz: bad symlink or ROFF `.so' request
>
> Can somebody help me and explain, what's going on?

These are all bugs in various manpages and can be ignored.


Regards,
Achim.
-- 
+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+

SD adaptations for KORG EX-800 and Poly-800MkII V0.9:
http://Synth.Stromeko.net/Downloads.html#KorgSDada

Re: [ANNOUNCEMENT] Updated: man-db-2.10.0-1

[Achim Gratz]

Achim Gratz writes:
> Does /var/cache/man exist and are the permissions sane?  I guess I need
> to make sure this gets created when installing the package, will note
> that for the next release.

I checked and it is already packaged.  So, what are the
permissions/contents?  If it exists, move it away and install man-db
again.


Regards,
Achim.
-- 
+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+

SD adaptations for Waldorf Q V3.00R3 and Q+ V3.54R2:
http://Synth.Stromeko.net/Downloads.html#WaldorfSDada

Re: [ANNOUNCEMENT] Updated: man-db-2.10.0-1

[Andrey Repin]

Greetings, Achim Gratz!

> Achim Gratz writes:
>> Does /var/cache/man exist and are the permissions sane?

Yes, and perms are mostly irrelevant, cause I install from elevated prompt.

/var/cache/man
# icacls . | iconv -f CP866
. daemon2\anrdaemon:(F)
  daemon2\None:(RX)
  Everyone:(RX)
  CREATOR-OWNER:(OI)(CI)(IO)(F)
  CREATOR-GROUP:(OI)(CI)(IO)(RX)
  Everyone:(OI)(CI)(IO)(RX)

Successfully processed 1 files; Failed processing 0 files

/var/cache/man
# acl .
# file: .
# owner: anrdaemon
# group: None
user::rwx
group::r-x
other::r-x
default:user::rwx
default:group::r-x
default:other::r-x

>> I guess I need
>> to make sure this gets created when installing the package, will note
>> that for the next release.

> I checked and it is already packaged.  So, what are the
> permissions/contents?  If it exists, move it away and install man-db
> again.

Turned out, I can easily reproduce it by

> # rm -rf /var/cache/man && mkdir /var/cache/man && touch /var/cache/man/index.db && mandb
> Purging old database entries in /usr/share/man...
> mandb: can't update index cache /var/cache/man/2070: No such file or directory
> Processing manual pages under /usr/share/man...
> mandb: can't create index cache /var/cache/man/2070: Resource temporarily unavailable

It creates CACHEDIR.TAG and cat1 cat3 cat5 cat6 cat7 cat8 subdirectories but
that's about it. Nothing else is saved and the index.db is unmodified.


-- 
With best regards,
Andrey Repin
Tuesday, February 8, 2022 10:48:10

Sorry for my terrible english...

Re: [ANNOUNCEMENT] Updated: man-db-2.10.0-1

[Achim Gratz]

Andrey Repin writes:
> Turned out, I can easily reproduce it by
>
>> # rm -rf /var/cache/man && mkdir /var/cache/man && touch /var/cache/man/index.db && mandb
>> Purging old database entries in /usr/share/man...
>> mandb: can't update index cache /var/cache/man/2070: No such file or directory
>> Processing manual pages under /usr/share/man...
>> mandb: can't create index cache /var/cache/man/2070: Resource temporarily unavailable
>
> It creates CACHEDIR.TAG and cat1 cat3 cat5 cat6 cat7 cat8 subdirectories but
> that's about it. Nothing else is saved and the index.db is unmodified.

Well, that file it tries to create is a temporary file (the filename is
the PID of the process creating it), so if that same process can create
directories and files, but then fails to create abother file, something
else must be interfering with it.


Regards,
Achim.
-- 
+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+

SD adaptations for Waldorf Q V3.00R3 and Q+ V3.54R2:
http://Synth.Stromeko.net/Downloads.html#WaldorfSDada

Re: [ANNOUNCEMENT] Updated: man-db-2.10.0-1

[Achim Gratz]

Achim Gratz writes:
> Well, that file it tries to create is a temporary file (the filename is
> the PID of the process creating it), so if that same process can create
> directories and files, but then fails to create abother file, something
> else must be interfering with it.

The particular error message would appear if the file operation
encountered an error other than EACCESS, EROFS, EAGAIN or EWOULDBLOCK.
If you strace mandb you might be able to see what that error actually is
(or it might simply work).


Regards,
Achim.
-- 
+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+

Waldorf MIDI Implementation & additional documentation:
http://Synth.Stromeko.net/Downloads.html#WaldorfDocs