diff mbox

[2/2] Document new -z/-Z options

Message ID 1364931149-18484-3-git-send-email-simo@redhat.com (mailing list archive)
State New, archived
Headers show

Commit Message

Simo Sorce April 2, 2013, 7:32 p.m. UTC
Options are not in alphabetical order but -z/-Z clearly always come last.

Signed-off-by: Simo Sorce <simo@redhat.com>
---
 utils/gssd/gssd.man |   13 ++++++++++++-
 1 files changed, 12 insertions(+), 1 deletions(-)

Comments

J. Bruce Fields April 3, 2013, 2:20 p.m. UTC | #1
On Tue, Apr 02, 2013 at 03:32:29PM -0400, Simo Sorce wrote:
> Options are not in alphabetical order but -z/-Z clearly always come last.
> 
> Signed-off-by: Simo Sorce <simo@redhat.com>
> ---
>  utils/gssd/gssd.man |   13 ++++++++++++-
>  1 files changed, 12 insertions(+), 1 deletions(-)
> 
> diff --git a/utils/gssd/gssd.man b/utils/gssd/gssd.man
> index 79d9bf91ac6b976c57d167e60d07f828a3ff5b1f..7918c2a0ff76c3918449cf3e1420f0a289929ac1 100644
> --- a/utils/gssd/gssd.man
> +++ b/utils/gssd/gssd.man
> @@ -8,7 +8,7 @@
>  rpc.gssd \- RPCSEC_GSS daemon
>  .SH SYNOPSIS
>  .B rpc.gssd
> -.RB [ \-fMnlvr ]
> +.RB [ \-fMnlvrzZ ]
>  .RB [ \-k
>  .IR keytab ]
>  .RB [ \-p
> @@ -266,6 +266,17 @@ new kernel contexts to be negotiated after
>  seconds, which allows changing Kerberos tickets and identities frequently.
>  The default is no explicit timeout, which means the kernel context will live
>  the lifetime of the Kerberos service ticket used in its creation.
> +.TP
> +.B -z
> +This option tries to avoid DNS Reverse (PTR) lookups for determining the 
> +server name to pass to GSSAPI if the name passed at mount point is not an IP 
> +address. Currently off by default for compatibility reasons.
> +.TP
> +.B -Z
> +This is the inverse of 
> +.B -z
> +and forces the use of DNS Reverse resolution of the server's IP address to
> +retrieve the server name to use in GSAPI authentication.

By the way I think with the "new" upcall, gssd ignores whatever it got
out of the info file if the "target=" parameter is provided in the
upcall.

(But looking at the code I think that's only used in the nfsv4.0
callback case, and isn't worth mentioning here.)

--b.

>  .SH SEE ALSO
>  .BR rpc.svcgssd (8),
>  .BR kerberos (1),
> -- 
> 1.7.1
> 
> --
> To unsubscribe from this list: send the line "unsubscribe linux-nfs" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
--
To unsubscribe from this list: send the line "unsubscribe linux-nfs" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Trond Myklebust April 3, 2013, 2:35 p.m. UTC | #2
On Wed, 2013-04-03 at 10:20 -0400, J. Bruce Fields wrote:
> On Tue, Apr 02, 2013 at 03:32:29PM -0400, Simo Sorce wrote:
> > Options are not in alphabetical order but -z/-Z clearly always come last.
> > 
> > Signed-off-by: Simo Sorce <simo@redhat.com>
> > ---
> >  utils/gssd/gssd.man |   13 ++++++++++++-
> >  1 files changed, 12 insertions(+), 1 deletions(-)
> > 
> > diff --git a/utils/gssd/gssd.man b/utils/gssd/gssd.man
> > index 79d9bf91ac6b976c57d167e60d07f828a3ff5b1f..7918c2a0ff76c3918449cf3e1420f0a289929ac1 100644
> > --- a/utils/gssd/gssd.man
> > +++ b/utils/gssd/gssd.man
> > @@ -8,7 +8,7 @@
> >  rpc.gssd \- RPCSEC_GSS daemon
> >  .SH SYNOPSIS
> >  .B rpc.gssd
> > -.RB [ \-fMnlvr ]
> > +.RB [ \-fMnlvrzZ ]
> >  .RB [ \-k
> >  .IR keytab ]
> >  .RB [ \-p
> > @@ -266,6 +266,17 @@ new kernel contexts to be negotiated after
> >  seconds, which allows changing Kerberos tickets and identities frequently.
> >  The default is no explicit timeout, which means the kernel context will live
> >  the lifetime of the Kerberos service ticket used in its creation.
> > +.TP
> > +.B -z
> > +This option tries to avoid DNS Reverse (PTR) lookups for determining the 
> > +server name to pass to GSSAPI if the name passed at mount point is not an IP 
> > +address. Currently off by default for compatibility reasons.
> > +.TP
> > +.B -Z
> > +This is the inverse of 
> > +.B -z
> > +and forces the use of DNS Reverse resolution of the server's IP address to
> > +retrieve the server name to use in GSAPI authentication.
> 
> By the way I think with the "new" upcall, gssd ignores whatever it got
> out of the info file if the "target=" parameter is provided in the
> upcall.

Correct.

> (But looking at the code I think that's only used in the nfsv4.0
> callback case, and isn't worth mentioning here.)

Wrong. It is also used for NFSv4 and NFSv4.1 state management.
IOW: SETCLIENTID/RENEW and for NFSv4.1 EXCHANGE_ID/SEQUENCE; anything
that uses clp->cl_machine_cred.
J. Bruce Fields April 3, 2013, 2:56 p.m. UTC | #3
On Wed, Apr 03, 2013 at 02:35:48PM +0000, Myklebust, Trond wrote:
> On Wed, 2013-04-03 at 10:20 -0400, J. Bruce Fields wrote:
> > On Tue, Apr 02, 2013 at 03:32:29PM -0400, Simo Sorce wrote:
> > > Options are not in alphabetical order but -z/-Z clearly always come last.
> > > 
> > > Signed-off-by: Simo Sorce <simo@redhat.com>
> > > ---
> > >  utils/gssd/gssd.man |   13 ++++++++++++-
> > >  1 files changed, 12 insertions(+), 1 deletions(-)
> > > 
> > > diff --git a/utils/gssd/gssd.man b/utils/gssd/gssd.man
> > > index 79d9bf91ac6b976c57d167e60d07f828a3ff5b1f..7918c2a0ff76c3918449cf3e1420f0a289929ac1 100644
> > > --- a/utils/gssd/gssd.man
> > > +++ b/utils/gssd/gssd.man
> > > @@ -8,7 +8,7 @@
> > >  rpc.gssd \- RPCSEC_GSS daemon
> > >  .SH SYNOPSIS
> > >  .B rpc.gssd
> > > -.RB [ \-fMnlvr ]
> > > +.RB [ \-fMnlvrzZ ]
> > >  .RB [ \-k
> > >  .IR keytab ]
> > >  .RB [ \-p
> > > @@ -266,6 +266,17 @@ new kernel contexts to be negotiated after
> > >  seconds, which allows changing Kerberos tickets and identities frequently.
> > >  The default is no explicit timeout, which means the kernel context will live
> > >  the lifetime of the Kerberos service ticket used in its creation.
> > > +.TP
> > > +.B -z
> > > +This option tries to avoid DNS Reverse (PTR) lookups for determining the 
> > > +server name to pass to GSSAPI if the name passed at mount point is not an IP 
> > > +address. Currently off by default for compatibility reasons.
> > > +.TP
> > > +.B -Z
> > > +This is the inverse of 
> > > +.B -z
> > > +and forces the use of DNS Reverse resolution of the server's IP address to
> > > +retrieve the server name to use in GSAPI authentication.
> > 
> > By the way I think with the "new" upcall, gssd ignores whatever it got
> > out of the info file if the "target=" parameter is provided in the
> > upcall.
> 
> Correct.
> 
> > (But looking at the code I think that's only used in the nfsv4.0
> > callback case, and isn't worth mentioning here.)
> 
> Wrong. It is also used for NFSv4 and NFSv4.1 state management.
> IOW: SETCLIENTID/RENEW and for NFSv4.1 EXCHANGE_ID/SEQUENCE; anything
> that uses clp->cl_machine_cred.

I was talk about "target=", but I believe you're talking about
"service=".

The former is a server name (myserver.example.com), the latter a service
name (nfs).

--b.
--
To unsubscribe from this list: send the line "unsubscribe linux-nfs" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Trond Myklebust April 3, 2013, 3:10 p.m. UTC | #4
On Wed, 2013-04-03 at 10:56 -0400, J. Bruce Fields wrote:
> On Wed, Apr 03, 2013 at 02:35:48PM +0000, Myklebust, Trond wrote:
> > On Wed, 2013-04-03 at 10:20 -0400, J. Bruce Fields wrote:
> > > On Tue, Apr 02, 2013 at 03:32:29PM -0400, Simo Sorce wrote:
> > > > Options are not in alphabetical order but -z/-Z clearly always come last.
> > > > 
> > > > Signed-off-by: Simo Sorce <simo@redhat.com>
> > > > ---
> > > >  utils/gssd/gssd.man |   13 ++++++++++++-
> > > >  1 files changed, 12 insertions(+), 1 deletions(-)
> > > > 
> > > > diff --git a/utils/gssd/gssd.man b/utils/gssd/gssd.man
> > > > index 79d9bf91ac6b976c57d167e60d07f828a3ff5b1f..7918c2a0ff76c3918449cf3e1420f0a289929ac1 100644
> > > > --- a/utils/gssd/gssd.man
> > > > +++ b/utils/gssd/gssd.man
> > > > @@ -8,7 +8,7 @@
> > > >  rpc.gssd \- RPCSEC_GSS daemon
> > > >  .SH SYNOPSIS
> > > >  .B rpc.gssd
> > > > -.RB [ \-fMnlvr ]
> > > > +.RB [ \-fMnlvrzZ ]
> > > >  .RB [ \-k
> > > >  .IR keytab ]
> > > >  .RB [ \-p
> > > > @@ -266,6 +266,17 @@ new kernel contexts to be negotiated after
> > > >  seconds, which allows changing Kerberos tickets and identities frequently.
> > > >  The default is no explicit timeout, which means the kernel context will live
> > > >  the lifetime of the Kerberos service ticket used in its creation.
> > > > +.TP
> > > > +.B -z
> > > > +This option tries to avoid DNS Reverse (PTR) lookups for determining the 
> > > > +server name to pass to GSSAPI if the name passed at mount point is not an IP 
> > > > +address. Currently off by default for compatibility reasons.
> > > > +.TP
> > > > +.B -Z
> > > > +This is the inverse of 
> > > > +.B -z
> > > > +and forces the use of DNS Reverse resolution of the server's IP address to
> > > > +retrieve the server name to use in GSAPI authentication.
> > > 
> > > By the way I think with the "new" upcall, gssd ignores whatever it got
> > > out of the info file if the "target=" parameter is provided in the
> > > upcall.
> > 
> > Correct.
> > 
> > > (But looking at the code I think that's only used in the nfsv4.0
> > > callback case, and isn't worth mentioning here.)
> > 
> > Wrong. It is also used for NFSv4 and NFSv4.1 state management.
> > IOW: SETCLIENTID/RENEW and for NFSv4.1 EXCHANGE_ID/SEQUENCE; anything
> > that uses clp->cl_machine_cred.
> 
> I was talk about "target=", but I believe you're talking about
> "service=".
>
> The former is a server name (myserver.example.com), the latter a service
> name (nfs).

Right, but gssd_refresh_krb5_machine_credential combines both in order
to create the keytab entry.
Trond Myklebust April 3, 2013, 3:27 p.m. UTC | #5
On Wed, 2013-04-03 at 11:10 -0400, Trond Myklebust wrote:
> On Wed, 2013-04-03 at 10:56 -0400, J. Bruce Fields wrote:
> > On Wed, Apr 03, 2013 at 02:35:48PM +0000, Myklebust, Trond wrote:
> > > On Wed, 2013-04-03 at 10:20 -0400, J. Bruce Fields wrote:
> > > > On Tue, Apr 02, 2013 at 03:32:29PM -0400, Simo Sorce wrote:
> > > > > Options are not in alphabetical order but -z/-Z clearly always come last.
> > > > > 
> > > > > Signed-off-by: Simo Sorce <simo@redhat.com>
> > > > > ---
> > > > >  utils/gssd/gssd.man |   13 ++++++++++++-
> > > > >  1 files changed, 12 insertions(+), 1 deletions(-)
> > > > > 
> > > > > diff --git a/utils/gssd/gssd.man b/utils/gssd/gssd.man
> > > > > index 79d9bf91ac6b976c57d167e60d07f828a3ff5b1f..7918c2a0ff76c3918449cf3e1420f0a289929ac1 100644
> > > > > --- a/utils/gssd/gssd.man
> > > > > +++ b/utils/gssd/gssd.man
> > > > > @@ -8,7 +8,7 @@
> > > > >  rpc.gssd \- RPCSEC_GSS daemon
> > > > >  .SH SYNOPSIS
> > > > >  .B rpc.gssd
> > > > > -.RB [ \-fMnlvr ]
> > > > > +.RB [ \-fMnlvrzZ ]
> > > > >  .RB [ \-k
> > > > >  .IR keytab ]
> > > > >  .RB [ \-p
> > > > > @@ -266,6 +266,17 @@ new kernel contexts to be negotiated after
> > > > >  seconds, which allows changing Kerberos tickets and identities frequently.
> > > > >  The default is no explicit timeout, which means the kernel context will live
> > > > >  the lifetime of the Kerberos service ticket used in its creation.
> > > > > +.TP
> > > > > +.B -z
> > > > > +This option tries to avoid DNS Reverse (PTR) lookups for determining the 
> > > > > +server name to pass to GSSAPI if the name passed at mount point is not an IP 
> > > > > +address. Currently off by default for compatibility reasons.
> > > > > +.TP
> > > > > +.B -Z
> > > > > +This is the inverse of 
> > > > > +.B -z
> > > > > +and forces the use of DNS Reverse resolution of the server's IP address to
> > > > > +retrieve the server name to use in GSAPI authentication.
> > > > 
> > > > By the way I think with the "new" upcall, gssd ignores whatever it got
> > > > out of the info file if the "target=" parameter is provided in the
> > > > upcall.
> > > 
> > > Correct.
> > > 
> > > > (But looking at the code I think that's only used in the nfsv4.0
> > > > callback case, and isn't worth mentioning here.)
> > > 
> > > Wrong. It is also used for NFSv4 and NFSv4.1 state management.
> > > IOW: SETCLIENTID/RENEW and for NFSv4.1 EXCHANGE_ID/SEQUENCE; anything
> > > that uses clp->cl_machine_cred.
> > 
> > I was talk about "target=", but I believe you're talking about
> > "service=".
> >
> > The former is a server name (myserver.example.com), the latter a service
> > name (nfs).
> 
> Right, but gssd_refresh_krb5_machine_credential combines both in order
> to create the keytab entry.
> 

Never mind. I see what you mean: we only set the
rpc_client->cl_principal for the case of NFSv4 callbacks to the client.
diff mbox

Patch

diff --git a/utils/gssd/gssd.man b/utils/gssd/gssd.man
index 79d9bf91ac6b976c57d167e60d07f828a3ff5b1f..7918c2a0ff76c3918449cf3e1420f0a289929ac1 100644
--- a/utils/gssd/gssd.man
+++ b/utils/gssd/gssd.man
@@ -8,7 +8,7 @@ 
 rpc.gssd \- RPCSEC_GSS daemon
 .SH SYNOPSIS
 .B rpc.gssd
-.RB [ \-fMnlvr ]
+.RB [ \-fMnlvrzZ ]
 .RB [ \-k
 .IR keytab ]
 .RB [ \-p
@@ -266,6 +266,17 @@  new kernel contexts to be negotiated after
 seconds, which allows changing Kerberos tickets and identities frequently.
 The default is no explicit timeout, which means the kernel context will live
 the lifetime of the Kerberos service ticket used in its creation.
+.TP
+.B -z
+This option tries to avoid DNS Reverse (PTR) lookups for determining the 
+server name to pass to GSSAPI if the name passed at mount point is not an IP 
+address. Currently off by default for compatibility reasons.
+.TP
+.B -Z
+This is the inverse of 
+.B -z
+and forces the use of DNS Reverse resolution of the server's IP address to
+retrieve the server name to use in GSAPI authentication.
 .SH SEE ALSO
 .BR rpc.svcgssd (8),
 .BR kerberos (1),