Date: Tue, 21 Jun 2011 12:07:04 -0400
From: Jeff Layton <jlayton@redhat.com>
To: "J. Bruce Fields" <bfields@fieldses.org>
Cc: steved@redhat.com, linux-nfs@vger.kernel.org, chuck.lever@oracle.com
Subject: Re: [PATCH] manpage: add info about IPv6 configuration to
 exports(5) (try #2)
Message-ID: <20110621120704.3b256de4@tlielax.poochiereds.net>
In-Reply-To: <20110621160057.GC25534@fieldses.org>
References: <1308665441-16704-1-git-send-email-jlayton@redhat.com>
	<20110621160057.GC25534@fieldses.org>
Content-Type: text/plain; charset=US-ASCII
Sender: linux-nfs-owner@vger.kernel.org
MIME-Version: 1.0

On Tue, 21 Jun 2011 12:00:57 -0400
"J. Bruce Fields" <bfields@fieldses.org> wrote:

> On Tue, Jun 21, 2011 at 10:10:41AM -0400, Jeff Layton wrote:
> > The parts of the exports(5) manpage that discuss IP addressing neglect
> > IPv6 configuration. Update to include info on how to export to IPv6
> > subnets and addresses, and add a line demonstrating that to the EXAMPLE
> > section.
> > 
> > Signed-off-by: Jeff Layton <jlayton@redhat.com>
> > ---
> >  utils/exportfs/exports.man |   11 +++++++----
> >  1 files changed, 7 insertions(+), 4 deletions(-)
> > 
> > diff --git a/utils/exportfs/exports.man b/utils/exportfs/exports.man
> > index 241b3af..f53da4e 100644
> > --- a/utils/exportfs/exports.man
> > +++ b/utils/exportfs/exports.man
> > @@ -47,7 +47,7 @@ NFS clients may be specified in a number of ways:
> >  .IP "single host
> >  This is the most common format. You may specify a host either by an
> >  abbreviated name recognized be the resolver, the fully qualified domain
> > -name, or an IP address.
> > +name, an IPv4 address, or an IPv6 address.
> >  .IP "IP networks
> >  You can also export directories to all hosts on an IP (sub-) network
> >  simultaneously. This is done by specifying an IP address and netmask pair
> > @@ -56,8 +56,9 @@ as
> >  where the netmask can be specified in dotted-decimal format, or as a
> >  contiguous mask length.
> >  For example, either `/255.255.252.0' or `/22' appended
> > -to the network base IPv4 address results in identical subnetworks with 10 bits of
> > -host. Wildcard characters generally do not work on IP addresses, though they
> > +to the network base IPv4 address results in identical subnetworks with 10 bits
> > +of host. IPv6 addresses must use a contiguous mask length. Wildcard characters
> 
> People use non-contiguous masks?
> 

No, I was just trying to be clear that you can't use a dotted-decimal
netmask for IPv6.

> > +generally do not work on IP addresses, though they
> >  may work by accident when reverse DNS lookups fail.
> >  .IP "wildcards
> >  Machine names may contain the wildcard characters \fI*\fR and \fI?\fR.
> > @@ -486,6 +487,7 @@ The format for extra export tables is the same as
> >  /home/joe       pc001(rw,all_squash,anonuid=150,anongid=100)
> >  /pub            *(ro,insecure,all_squash)
> >  /srv/www        \-sync,rw server @trusted @external(ro)
> > +/foo            2001:321:9:e54::/64(rw) 192.168.1.0/24(rw)
> 
> (Any reason for that particular example address?  Just curious.)
> 
> --b.
> 

Nope -- pulled that out of my nether regions.

> >  '''/pub/private    (noaccess)
> >  .fi
> >  .PP
> > @@ -501,7 +503,8 @@ option in this entry also allows clients with NFS implementations that
> >  don't use a reserved port for NFS.
> >  The sixth line exports a directory read-write to the machine 'server'
> >  as well as the `@trusted' netgroup, and read-only to netgroup `@external',
> > -all three mounts with the `sync' option enabled.
> > +all three mounts with the `sync' option enabled. The seventh line exports
> > +a directory to both an IPv6 and an IPv4 subnet.
> >  ''' The last line denies all NFS clients
> >  '''access to the private directory.
> >  '''.SH CAVEATS
> > -- 
> > 1.7.5.4
> > 
> > --
> > 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


-- 
Jeff Layton <jlayton@redhat.com>