Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-06 Thread Simon Geard
On Tue, 2010-01-05 at 22:27 -0500, Chris Staub wrote:
 Although, If you are using this option would likely not be necessary, 
 as it's part of the default login.defs, so it would pretty much be used 
 by everyone. Otherwise, anyone who is using it would add it themselves, 
 in which case they wouldn't need to be told what it's for. So...yeah, 
 the fact that the user never even creates it themselves would be a valid 
 reason to explain exactly what it's for.

If it's actually a default option, that's even worse - we can't just
provide a note explaining what ENV_SUPATH is used for. You're saying
that unless the user performs a specific action (i.e modify root's login
scripts), the version of Shadow *with* PAM will behave significantly
differently from the version installed in LFS.

That's not good... it doesn't teach anything, it just gives the user
problems with no clear reason. If these things *must* be done, they
should be instructions in the book, even if those instructions are as
simple as saying root's login scripts must be changed to add /sbin
and /usr/sbin to the path. A simple Note: just doesn't cut it...

Simon.


signature.asc
Description: This is a digitally signed message part
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Chris Staub
On 12/31/2009 05:25 PM, stosss wrote:
 At the bottom of the page for shadow in the BLFS svn book latest and
 earlier versions. Is this note talking about a step that was done or
 needs to be done?

 Note

 ENV_SUPATH is no longer supported. You must create a valid
 /root/.bashrc file to provide a modified path for the super-user.

I don't think it's in any way unclear, but I'll explain anyway...

ENV_SUPATH is an option in /etc/login.defs, specifying the default PATH 
for the root user. However, the Shadow page in BLFS assumes you are 
rebuiding Shadow with PAM support, and if you are using PAM, ENV_SUPATH 
no longer does anything.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread stosss
 At the bottom of the page for shadow in the BLFS svn book latest and
 earlier versions. Is this note talking about a step that was done or
 needs to be done?

 Note

 ENV_SUPATH is no longer supported. You must create a valid
 /root/.bashrc file to provide a modified path for the super-user.

 I don't think it's in any way unclear, but I'll explain anyway...

 ENV_SUPATH is an option in /etc/login.defs, specifying the default PATH
 for the root user. However, the Shadow page in BLFS assumes you are
 rebuiding Shadow with PAM support, and if you are using PAM, ENV_SUPATH
 no longer does anything.

 I got that. Is it telling about a process that was done in the steps
 above on the shadow page _or_ is it telling about something that still
 needs (or might need) to be done?
 --

 I think the note means that the variable is defined in the file, but
 has no effect when using PAM. The note names one possible workaround
 to modify the super-user path when using shadow with PAM support.
 ENV_SUPATH exists in /etc/login.defs but does not do or cause any
 behavior.

 So the note mentions a step that has not yet been performed nor is
 described in detail.

That is what I thought. If the authors thought it was necessary to
make the note, then why not say if the undescribed step is important
or what possible problems might be seen by not doing the step? Why not
explain how to do the step? If not doing the step won't cause any
problem then why mention it at all?
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Chris Staub
On 01/05/2010 03:58 PM, stosss wrote:

 I don't think it's in any way unclear, but I'll explain anyway...

 ENV_SUPATH is an option in /etc/login.defs, specifying the default PATH
 for the root user. However, the Shadow page in BLFS assumes you are
 rebuiding Shadow with PAM support, and if you are using PAM, ENV_SUPATH
 no longer does anything.

 I got that. Is it telling about a process that was done in the steps
 above on the shadow page _or_ is it telling about something that still
 needs (or might need) to be done?

It looks like you're overthinking things and reading more into what's on 
the page then what's there. It's referring to exactly what is done on 
that page - configuring Shadow to use PAM. In particular, it follows up 
on the previous note about the regular path now being handled by a PAM 
module and configured in a .conf file - it's just that there apparently 
isn't any PAM config for the superuser specifically, so the additional 
note was added about adding to root's .bashrc.

Though I could also point out that if you look at that long sed command 
that modifies login.defs by commenting out a bunch of vars (see the 
command under the Configuring /etc/login.defs section), you'll see 
that ENV_SUPATH is on the list...

Then there's the NOTE immediately after Shadow is installed:

The rest of this page is devoted to configuring Shadow to work properly 
with Linux-PAM.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread stosss
 It looks like you're overthinking things and reading more into what's on
 the page then what's there. It's referring to exactly what is done on
 that page - configuring Shadow to use PAM. In particular, it follows up
 on the previous note about the regular path now being handled by a PAM
 module and configured in a .conf file - it's just that there apparently
 isn't any PAM config for the superuser specifically, so the additional
 note was added about adding to root's .bashrc.

Adding _what_ (and how) to root's .bashrc?
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Chris Staub
On 01/05/2010 05:16 PM, stosss wrote:
 It looks like you're overthinking things and reading more into what's on
 the page then what's there. It's referring to exactly what is done on
 that page - configuring Shadow to use PAM. In particular, it follows up
 on the previous note about the regular path now being handled by a PAM
 module and configured in a .conf file - it's just that there apparently
 isn't any PAM config for the superuser specifically, so the additional
 note was added about adding to root's .bashrc.

 Adding _what_ (and how) to root's .bashrc?

Pasted from the Note in question:

You must create a valid /root/.bashrc file to provide a modified path 
for the super-user.

Therefore, to your question of what to add to root's .bashrc - it's a 
modified path. You know, since root generally has additional dirs in 
its PATH (such as /sbin and /usr/sbin).
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread stosss
 You must create a valid /root/.bashrc file to provide a modified path
 for the super-user.

 Therefore, to your question of what to add to root's .bashrc - it's a
 modified path. You know, since root generally has additional dirs in
 its PATH (such as /sbin and /usr/sbin).

I understand that but you said the note was clear. It is not at all clear.

You must(doesn't say why you must. Must is strong. Where is the cause
and effect?) create a valid /root/.bashrc file to provide a modified
path(what should that modified path look like?)
for the super-user.

The note has the appearance of something important without giving
supporting detail as to why it is important.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Simon Geard
On Tue, 2010-01-05 at 17:16 -0500, stosss wrote:
  It looks like you're overthinking things and reading more into what's on
  the page then what's there. It's referring to exactly what is done on
  that page - configuring Shadow to use PAM. In particular, it follows up
  on the previous note about the regular path now being handled by a PAM
  module and configured in a .conf file - it's just that there apparently
  isn't any PAM config for the superuser specifically, so the additional
  note was added about adding to root's .bashrc.
 
 Adding _what_ (and how) to root's .bashrc?

Adding whatever you were previously using ENV_SUPATH for. If you weren't
previously using ENV_SUPATH, you've got nothing to worry about.

Simon.



signature.asc
Description: This is a digitally signed message part
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Simon Geard
On Tue, 2010-01-05 at 17:21 -0500, Chris Staub wrote:
 Pasted from the Note in question:
 
 You must create a valid /root/.bashrc file to provide a modified path 
 for the super-user.
 
 Therefore, to your question of what to add to root's .bashrc - it's a 
 modified path. You know, since root generally has additional dirs in 
 its PATH (such as /sbin and /usr/sbin).

Reading that, I think he's actually got a fair point. The intended
meaning is that if you were previously using ENV_SUPATH to give root a
different PATH from ordinary users, you would now need to do so by
modifying root's login scripts.

But if you read that note, it starts by assuming the reader actually
knows what ENV_SUPATH is, and why it being no longer supported means
they have to create a suitable .bashrc file. If they don't know what
ENV_SUPATH is, they're merely left with a cryptic instruction to create
a .bashrc file with unspecified content.

And consider, ENV_SUPATH isn't mentioned in the LFS shadow page, and
only mentioned in this page in the context of saying it can't be used. A
typical LFS builder is *not* going to know what that message means.

A better wording would perhaps be something like:

Note: The ENV_SUPATH option used to modify root's default path does not
work with PAM. If you are using this option, you'll need to set the path
in root's login scripts instead.

To me, that explains what it does, and makes it clear that if you don't
use it, you don't need to do anything.

Simon.


signature.asc
Description: This is a digitally signed message part
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Chris Staub
On 01/05/2010 09:47 PM, Simon Geard wrote:

 Reading that, I think he's actually got a fair point. The intended
 meaning is that if you were previously using ENV_SUPATH to give root a
 different PATH from ordinary users, you would now need to do so by
 modifying root's login scripts.

 But if you read that note, it starts by assuming the reader actually
 knows what ENV_SUPATH is, and why it being no longer supported means
 they have to create a suitable .bashrc file. If they don't know what
 ENV_SUPATH is, they're merely left with a cryptic instruction to create
 a .bashrc file with unspecified content.

 And consider, ENV_SUPATH isn't mentioned in the LFS shadow page, and
 only mentioned in this page in the context of saying it can't be used. A
 typical LFS builder is *not* going to know what that message means.

 A better wording would perhaps be something like:

 Note: The ENV_SUPATH option used to modify root's default path does not
 work with PAM. If you are using this option, you'll need to set the path
 in root's login scripts instead.

 To me, that explains what it does, and makes it clear that if you don't
 use it, you don't need to do anything.

 Simon.


Yeah, I suppose it's would be reasonable to specify what ENV_SUPATH 
does. I think I just let myself get carried away with emphasizing the 
when is it needed part and didn't see that yes, he does have a point 
about explaining what that var does.

Although, If you are using this option would likely not be necessary, 
as it's part of the default login.defs, so it would pretty much be used 
by everyone. Otherwise, anyone who is using it would add it themselves, 
in which case they wouldn't need to be told what it's for. So...yeah, 
the fact that the user never even creates it themselves would be a valid 
reason to explain exactly what it's for.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread stosss
On Tue, Jan 5, 2010 at 9:47 PM, Simon Geard delga...@ihug.co.nz wrote:
 On Tue, 2010-01-05 at 17:21 -0500, Chris Staub wrote:
 Pasted from the Note in question:

 You must create a valid /root/.bashrc file to provide a modified path
 for the super-user.

 Therefore, to your question of what to add to root's .bashrc - it's a
 modified path. You know, since root generally has additional dirs in
 its PATH (such as /sbin and /usr/sbin).

 Reading that, I think he's actually got a fair point. The intended
 meaning is that if you were previously using ENV_SUPATH to give root a
 different PATH from ordinary users, you would now need to do so by
 modifying root's login scripts.

 But if you read that note, it starts by assuming the reader actually
 knows what ENV_SUPATH is, and why it being no longer supported means
 they have to create a suitable .bashrc file. If they don't know what
 ENV_SUPATH is, they're merely left with a cryptic instruction to create
 a .bashrc file with unspecified content.

 And consider, ENV_SUPATH isn't mentioned in the LFS shadow page, and
 only mentioned in this page in the context of saying it can't be used. A
 typical LFS builder is *not* going to know what that message means.

 A better wording would perhaps be something like:

 Note: The ENV_SUPATH option used to modify root's default path does not
 work with PAM. If you are using this option, you'll need to set the path
 in root's login scripts instead.

 To me, that explains what it does, and makes it clear that if you don't
 use it, you don't need to do anything.

Thanks Simon for making this clear. It had no useful meaning to me the
way it is currently written.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread stosss
 Reading that, I think he's actually got a fair point. The intended
 meaning is that if you were previously using ENV_SUPATH to give root a
 different PATH from ordinary users, you would now need to do so by
 modifying root's login scripts.

 But if you read that note, it starts by assuming the reader actually
 knows what ENV_SUPATH is, and why it being no longer supported means
 they have to create a suitable .bashrc file. If they don't know what
 ENV_SUPATH is, they're merely left with a cryptic instruction to create
 a .bashrc file with unspecified content.

 And consider, ENV_SUPATH isn't mentioned in the LFS shadow page, and
 only mentioned in this page in the context of saying it can't be used. A
 typical LFS builder is *not* going to know what that message means.

 A better wording would perhaps be something like:

 Note: The ENV_SUPATH option used to modify root's default path does not
 work with PAM. If you are using this option, you'll need to set the path
 in root's login scripts instead.

 To me, that explains what it does, and makes it clear that if you don't
 use it, you don't need to do anything.

 Simon.


 Yeah, I suppose it's would be reasonable to specify what ENV_SUPATH
 does. I think I just let myself get carried away with emphasizing the
 when is it needed part and didn't see that yes, he does have a point
 about explaining what that var does.

 Although, If you are using this option would likely not be necessary,
 as it's part of the default login.defs, so it would pretty much be used
 by everyone. Otherwise, anyone who is using it would add it themselves,
 in which case they wouldn't need to be told what it's for. So...yeah,
 the fact that the user never even creates it themselves would be a valid
 reason to explain exactly what it's for.

Thank you! That is all I was trying to accomplish when I asked my
original question. There are parts of the LFS and BLFS book written in
a way that leaves less experienced users scratching their head
wondering what they just read because it is written on the assumption
the reader already knows the subject matter and that is not true 100%
of the time. Then when authors or users defend the poorly written
parts that just makes it worse. I will bet that is the reason most of
the time for the conflict between new comers with less experience and
those with more.

The LFS project says the books are for learning. If something is
written so less experienced users don't understand then change those
parts. Don't get defensive and attack the person asking about them. It
happens all the time on the LFS list and it happened to me the very
first time I posted on this list.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Agathoklis D. Hatzimanikas
On Tue, Jan 05, at 10:27 Chris Staub wrote:
 On 01/05/2010 09:47 PM, Simon Geard wrote:
 
  Reading that, I think he's actually got a fair point. The intended
  meaning is that if you were previously using ENV_SUPATH to give root a
  different PATH from ordinary users, you would now need to do so by
  modifying root's login scripts.
 
  But if you read that note, it starts by assuming the reader actually
  knows what ENV_SUPATH is, and why it being no longer supported means
  they have to create a suitable .bashrc file. If they don't know what
  ENV_SUPATH is, they're merely left with a cryptic instruction to create
  a .bashrc file with unspecified content.
 
  And consider, ENV_SUPATH isn't mentioned in the LFS shadow page, and
  only mentioned in this page in the context of saying it can't be used. A
  typical LFS builder is *not* going to know what that message means.
 
  A better wording would perhaps be something like:
 
  Note: The ENV_SUPATH option used to modify root's default path does not
  work with PAM. If you are using this option, you'll need to set the path
  in root's login scripts instead.
 
  To me, that explains what it does, and makes it clear that if you don't
  use it, you don't need to do anything.
 
  Simon.
 
 
 Yeah, I suppose it's would be reasonable to specify what ENV_SUPATH 
 does. I think I just let myself get carried away with emphasizing the 
 when is it needed part and didn't see that yes, he does have a point 
 about explaining what that var does.
 
 Although, If you are using this option would likely not be necessary, 
 as it's part of the default login.defs, so it would pretty much be used 
 by everyone. Otherwise, anyone who is using it would add it themselves, 
 in which case they wouldn't need to be told what it's for. So...yeah, 
 the fact that the user never even creates it themselves would be a valid 
 reason to explain exactly what it's for.

I think that the following note is more than enough and it looks quite
clear.

Note:
The ENV_SUPATH option used to modify root's default path does not
work with PAM. You have to set the path in root's login scripts instead.

I will commit it in a second.

Thanks. 

Regards,
Agathoklis.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread stosss
Note: The ENV_SUPATH option used to modify root's default path does not
work with PAM. If you are using this option, you'll need to set the path
in root's login scripts instead.

This one is clear.

Note:
The ENV_SUPATH option used to modify root's default path does not
work with PAM. You have to set the path in root's login scripts instead.

This one is not clear.

If you are using this option,

Is what makes it clear. If a user does not understand or use
ENV_SUPATH they won't be concerned with the note if it has the part in
it that you pulled out.

If a user is using and understands ENV_SUPATH they will know they need
to make adjustments.
Why complicate things for the less experienced readers when it is not necessary?

This note won't bother me again because I have been educated thanks to Simon.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Chris Staub
On 01/05/2010 11:34 PM, stosss wrote:
 Note: The ENV_SUPATH option used to modify root's default path does not
 work with PAM. If you are using this option, you'll need to set the path
 in root's login scripts instead.

 This one is clear.

 Note:
 The ENV_SUPATH option used to modify root's default path does not
 work with PAM. You have to set the path in root's login scripts instead.

 This one is not clear.

 If you are using this option,

 Is what makes it clear. If a user does not understand or use
 ENV_SUPATH they won't be concerned with the note if it has the part in
 it that you pulled out.


I already pointed this out. Basically, I believe the opposite - adding 
if you are using makes it *less* clear, as *everyone* uses it by 
default, even if they don't know it.

 If a user is using and understands ENV_SUPATH they will know they need
 to make adjustments.

And as I already pointed out, if the if you are using part were there, 
that would imply that ENV_SUPATH is something added by the user (which 
it is NOT) and therefore anyone who did use it wouldn't need it 
explained anyway.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page


Re: BLFS svn book Shadow-4.1.4.2 question about a page note

2010-01-05 Thread Agathoklis D. Hatzimanikas
On Tue, Jan 05, at 11:34 stosss wrote:
 Note: The ENV_SUPATH option used to modify root's default path does not
 work with PAM. If you are using this option, you'll need to set the path
 in root's login scripts instead.
 
 This one is clear.
 
 Note:
 The ENV_SUPATH option used to modify root's default path does not
 work with PAM. You have to set the path in root's login scripts instead.
 
 This one is not clear.
 
 If you are using this option,
 
 Is what makes it clear.

By that it looks to me, that we are some kind of a project, that we are
caring about our customers (an already established audience). It sounds
like the note to be intended for *experienced* users, which is quite the
opposite from what you say a little bit bellow to your email.

 If a user does not understand or use ENV_SUPATH they won't be concerned
 with the note if it has the part in it that you pulled out.

But we expect from the readers (which is a little bit different than
to say users), to understand and to be concerned with
everything it is written in the books. That is our purpose.

As far the ENV_SUPATH, we want from the reader to understand its
importance, otherwise we wouldn't sacrifice a valuable space in the page
with a note that will (probably) make the page more complicated
and bloated, and you know what: somehow this page it is already
complicated. But the shadow suite is really important, because it
concerns security.

 If a user is using and understands ENV_SUPATH they will know they need
 to make adjustments.
 Why complicate things for the less experienced readers when it is not 
 necessary?

Honestly, we are not trying to complicated things on purpose, as a matter
of fact, we are trying to clarify and improve the wording when it is possible,
and anyway that is the meaning of this discussion, and let me say that: I
could be wrong and you could be right and perhaps later on, I can
understand the difference in the small details and change the note
accordingly.

 This note won't bother me again because I have been educated thanks to Simon.

Seriously: then our mission is complete and we are very happy for that.

Regards,
Agathoklis.
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page