Bug#981728: please document eipp.log
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.
>
> > 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.
>
> > It contains a dump of the last ordering request, it does not grow.
>
> So it is more like Xorg.log.0 than apt.log, right?
Sort of? It's just a dump in one go thing, not a log stream.
>
> > 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.
All the concerns raised here also apply to edsp, and well any log file.
--
debian developer - deb.li/jak | jak-linux.org - free software dev
ubuntu core developer i speak de, en
Reply to: