[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#981728: please document eipp.log



Hi,

Quoting Julian Andres Klode (2021-02-03 12:53:18)
> On Wed, Feb 03, 2021 at 12:41:02PM +0100, Marc Haber wrote:
> > On Wed, Feb 03, 2021 at 12:02:43PM +0100, Julian Andres Klode wrote:
> > > On Wed, Feb 03, 2021 at 11:54:23AM +0100, Marc Haber wrote:
> > > > recent apt versions write /var/log/apt/eipp.log.xz. This is not
> > > > documented anywhere, codesearch just finds a handful of appearances,
> > > > none of which gives any advice.
> > > > 
> > > > Please document what the file is, what is written to it, why there is no
> > > > log rotation, and how to turn it off ;-)
> > > 
> > > It's documented in doc/external-installation-planner-protocol.md
> > > (e-i-p-p), which is installed in apt-doc as
> > > 
> > >  /usr/share/doc/apt/external-installation-planner-protocol.md.gz
> > zgrep -i eipp.log /usr/share/doc/apt/external-installation-planner-protocol.md.gz
> > (nothing)
> Well sure, it documents the format, not a file location.

cool. But could we connect the term "eipp.log" and its documentation
*somewhere*? You remember we recently talked about that in #debian-apt and back
then I was just as confused as Marc is right now what /var/log/apt/eipp.log.xz
is about.

This doesn't mean that external-installation-planner-protocol.md has to point
to eipp.log.xz if you say that this file should just document the format. But
somewhere in the docs there should be a find-able connection between
/var/log/apt/eipp.log.xz and external-installation-planner-protocol.md.

> > > What do you think is missing? Did you look at /usr/share/doc/apt after
> > > installing apt-doc?
> > I grepped. Also, the string "log" doesn't show up in any other places
> > then in the word terminoLOGy. This is impossible to find if you don't
> > know exactly what you're searching for.
> Probably needs some fixing some day. Probably after bullseye, we don't
> want to invalidate all those translations now I suppose.

That would be great. Thanks!

> > > It will be useful if installating ordering failed for you and we ask you
> > > to please attach eipp.log.xz when you report the bug :-)
> > How would I turn it off for my servers that will never ever report a bug
> > against apt (because I have a test environment to reproduce bugs in before
> > I report them)?
> 
> $ apt-config dump | grep eipp
> Dir::Log::Planner "eipp.log.xz";
> 
> Set it to /dev/null just like any other file.

Thanks, this is great to know!

> All the concerns raised here also apply to edsp, and well any log file.

Yes, fixing those would be awesome as well. :)

Thanks!

cheers, josch

Attachment: signature.asc
Description: signature


Reply to: