Index: /trunk/Nebulous/Changes
===================================================================
--- /trunk/Nebulous/Changes	(revision 17845)
+++ /trunk/Nebulous/Changes	(revision 17846)
@@ -2,4 +2,5 @@
 
 0.09
+    - add neb-copies util
     - move print_all_xattrs(), print_xattrs(), write_xattrs(), delete_xattrs(),
       and parse_xattr_pair() from neb-xattr into Nebulous::Util
Index: /trunk/Nebulous/MANIFEST
===================================================================
--- /trunk/Nebulous/MANIFEST	(revision 17845)
+++ /trunk/Nebulous/MANIFEST	(revision 17846)
@@ -9,4 +9,5 @@
 autogen.sh
 bin/neb-cat
+bin/neb-copies
 bin/neb-cp
 bin/neb-cull
Index: /trunk/Nebulous/bin/neb-copies
===================================================================
--- /trunk/Nebulous/bin/neb-copies	(revision 17846)
+++ /trunk/Nebulous/bin/neb-copies	(revision 17846)
@@ -0,0 +1,134 @@
+#!/usr/bin/env perl
+
+# Copyright (C) 2008  Joshua Hoblitt
+#
+# $Id: neb-copies,v 1.1 2008-05-29 04:25:25 jhoblitt Exp $
+
+use strict;
+use warnings FATAL => qw( all );
+
+use vars qw( $VERSION );
+$VERSION = '0.01';
+
+use Nebulous::Client;
+use Nebulous::Util 0.02 qw( :standard );
+
+use Getopt::Long qw( GetOptions :config auto_help auto_version );
+use Pod::Usage qw( pod2usage );
+
+my ($server, $delete, $write);
+
+$server = $ENV{'NEB_SERVER'} unless $server;
+
+GetOptions(
+    'server|s=s'    => \$server,
+) || pod2usage( 2 );
+
+my ($key, $value) = (shift, shift);
+
+pod2usage( -msg => "Unknown option: @ARGV", -exitval => 2 ) if @ARGV;
+pod2usage( -msg => "Required options: --server", -exitval => 2 )
+    unless $server;
+pod2usage( -msg => "missing nebulous key", exitval => 2 )
+    unless defined $key;
+
+my $neb = Nebulous::Client->new(
+    proxy => "$server",
+);
+
+die "can't connect to Nebulous Server: $server"
+    unless defined $neb;
+
+# key with value write/overwrite user.copies:value
+if (defined $value) {
+    write_xattrs($neb, $key, "user.copies:$value") or die;
+    exit(0);
+}
+
+# key without value means print the value of user.copies.
+print_xattrs($neb, $key, "user.copies") or die;
+exit(0);
+
+
+
+__END__
+
+=pod
+
+=head1 NAME
+
+neb-copies - get/set how many copies Nebulous should attempt to keep
+
+=head1 SYNOPSIS
+
+    neb-copies [--server <URL>] <key> [<value>]
+
+=head1 DESCRIPTION
+
+This program can retrieve or store the xattr attribute C<user.copies>.  If
+invoked with just C<<key>> it will print the value.  If invoked with C<<key>>
+and C<<value>> it will set the value.
+
+=head1 OPTIONS
+
+=over 4
+
+=item * --server|-s <URL>
+
+URL of the Nebulous server to connect to.
+
+Optional if the appropriate environment variable is set.
+
+=back
+
+=head1 ENVIRONMENT
+
+These environment variables may be used in place of the specified command line
+options.  All command line option will override the corresponding environment
+value.
+
+=over 4
+
+=item * C<NEB_SERVER>
+
+Equivalent to --server|-s
+
+=back
+
+=head1 CREDITS
+
+Just me, myself, and I.
+
+=head1 SUPPORT
+
+Please contact the author directly via e-mail.
+
+=head1 AUTHOR
+
+Joshua Hoblitt <jhoblitt@cpan.org>
+
+=head1 COPYRIGHT
+
+Copyright (C) 2007-2008  Joshua Hoblitt.  All rights reserved.
+
+This program is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation; either version 2 of the License, or (at your option) any later
+version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with
+this program; if not, write to the Free Software Foundation, Inc., 59 Temple
+Place - Suite 330, Boston, MA  02111-1307, USA.
+
+The full text of the license can be found in the L<perlgpl> Pod as supplied
+with Perl 5.8.1 and later.
+
+=head1 SEE ALSO
+
+L<Nebulous::Server>, L<neb-initdb>, L<neb-addvol>, L<nebdiskd>, L<neb-df>
+
+=cut