new hierarchical support for xdsh/xdcp, with error processing and -c flag

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@4730 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd

xCAT-client/pods/man1/xdsh.1.pod

@@ -15,8 +15,9 @@ B<xdsh> I<noderange>  [B<-K>] [B<-l>  I<userID>]
 
 B<xdsh> [B<-i> I<image path>] I<command_list>
 
-B<xdsh> [B<-h> | B<-V> | B<-q>]
+B<xdsh> I<servicenoderange>  [B<-c>] 
 
+B<xdsh> [B<-h> | B<-V> | B<-q>]
 
 =head1 B<DESCRIPTION>
 
@@ -176,6 +177,15 @@ running commands, are terminated (SIGTERM).
 =over 5
 
 
+=item B<-c>|B<--cleanup>
+
+This flag will have xdsh remove all files from the subdirectories of the
+the directory on the Service Node, where xdcp will copy the files from the
+ MN that will eventually be copied to the compute nodes as defined in the
+site table SNsyncfiledir attribute.  Default is /var/xcat/syncfiles.
+This is usually used when this directory has grown too large or is in an 
+error state.   
+
 =item B<-e>|B<--execute>
 
 Indicates  that I<command_list> specifies a local script
@@ -500,7 +510,6 @@ on the service node fedora9 diskless image, enter:
 
 B<xdsh> I<-i /install/netboot/fedora9/x86_64/service/rootimg "rpm -qa | grep xCAT">
 
-
 =item *
 
 To run on AIX, the xdsh command "lslpp -l | grep bos"  
@@ -508,6 +517,13 @@ on the NIM 611dskls spot, enter:
 
 B<xdsh> I<-i /install/nim/spot/611dskls "/usr/bin/lslpp -l | grep bos">
 
+=item *
+
+To cleanup the servicenode directory that stages the copy of files to the
+nodes, enter:  
+
+B<xdsh> <servicenoderange -c >  
+
 =back
 
 =head1 B<Files>