News for hackers. Stuff that matters.
Re:SELinux is unmanageable; just turn it off if it gets in y... by nisa on Wednesday April 27, 2022 @05:31AM (#31177999)
> Wouldn't it be great if the man page of getaddrinfo mentioned those (mine only mentions gai.conf)

That's a huge part of the problem. Was looking for a monograph to pass on my successor that wasn't so familiar with linux - modern linux - as in systemd, docker, nssswitch, pam_homed, network-manager is penetrable but more often than not I'm just looking at the c source in github and I am in my 30ies, starting in my teens running linux nonstop and I'm still throwing up my hands every other day...

Add time constraints and pressure to deliver (don't waste your time understanding this, just do xyz) and here we are - on the other hand it's not okay that you have to devote years of trail and error to get a comprehensive undestanding of the system.

I guess a nuclear power plant has at least a training plan and complete reference book - that still needs to be read and grokked and trained upon but modern linux is often just undestandable by reading the source if you hit a problem - for some projects like things in the freedesktop ecosystem and partly systemd even that is kind of difficult because i.e. this bug https://github.com/systemd/systemd/issues/19118 explains the problem - there is no overview documentation, no clear way to look up what's happening, not even a good way to introspect and it's several components that interact with each other fail subtly. I've chosen this one because I've also hit it, not because I want to blame systemd, which is not so bad there are much worse things out there but it's part of a trend to introduce complexity - not sure what is necessary complexity and what is unnecessary - went to uni in compsci without ever someone slapping out of the tar pit (http://curtclifton.net/papers/MoseleyMarks06a.pdf) in my face and maybe that's part of the problem.

Re:SELinux is unmanageable; just turn it off if it gets in y... by throw0101a on Wednesday April 27, 2022 @07:43AM (#31178697)
> there is no overview documentation,

Documentation on Linux has always been shit.

Re:SELinux is unmanageable; just turn it off if it gets in y... by A4ET8a8uTh0 on Wednesday April 27, 2022 @08:51AM (#31179223)
Huh? Compared to what exactly? Man-pages compared to MS provided info are fairly exhaustive..

Now if we are talking of a documentation of a random project on github..

Re:SELinux is unmanageable; just turn it off if it gets in y... by throw0101a on Wednesday April 27, 2022 @09:34AM (#31179667)
The BSDs. When I admined Solaris there was also very good docs.

The man depend on the utility. Except for the GNU stuff, where the man pages often tell you to look at the info pages.

Re:SELinux is unmanageable; just turn it off if it gets in y... by greedo on Wednesday April 27, 2022 @11:05AM (#31180798)
Growing up on FBSD, it was quite the shock when I started working with RHEL/Debian. The qualitative difference between the manpages was disturbing.