Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NAME
     prm -- delete a file or files on a cluster of machines

SYNOPSIS
     prm [-dfrPRW] [-g nodegroup1,...,nodegroupN] [-w node1,...,nodeN]
	 [-x node1,...,nodeN] file ...

DESCRIPTION
     The  prm utility can be used to delete files or directories on a cluster of
     machines.	The following options are available:

     -d   Attempt to remove directories as well as other types of files.

     -f   Attempt to remove the files without prompting  for  confirmation,  re-
	  gardless  of	the  file's permissions.  If the file does not exist, do
	  not display a diagnostic message or modify the exit status to  reflect
	  an error.

     -P   Overwrite  regular  files before deleting them.  Files are overwritten
	  three times, first with the byte pattern 0xff,  then	0x00,  and  then
	  0xff again, before they are deleted.

     -R   Attempt  to  remove  the  file hierarchy rooted in each file argument.
	  The -R option implies the -d option.

     -r   Equivalent to -R.

     -W   Attempts to undelete the named files.  Currently, this option can only
	  be used to recover files covered by whiteouts.

     -g   If the -g option is specified, followed by a comma separated	list  of
	  group  names,  the command will only be run on that group of nodes.  A
	  node may be a part of more than one group if desired, however  running
	  without  the	-g  option will run the command on the same node as many
	  times as it appears in the file specified by the  CLUSTER  environment
	  variable.  This option is silently ignored if used with the -w option.

     -w   If  the  -w option is specified, followed by a comma delimited list of
	  machine names, the command will be run  on  each  node  in  the  list.
	  Without this flag, prm runs on the nodes listed in the file pointed to
	  by the CLUSTER environment variable.

     -x   The  -x option can be used to exclude specific nodes from the cluster.
	  The format is the same as the -w option, a comma delimited list of ma-
	  chine names.	This option is silently ignored if used with the -w  op-
	  tion.

ENVIRONMENT
     prm utilizes the following environment variables.

     CLUSTER   Contains  a  filename, which is a newline separated list of nodes
	       in the cluster.

     RCMD_CMD  Command to use to connect to remote machines.  The command chosen
	       must be able to connect with no password to the remote host.  De-
	       faults to rsh

DIAGNOSTICS
     Exit status is 0 on success, 1 if an error occurs.

SEE ALSO
     dsh(1), rm(1), rsh(1), kerberos(3), hosts.equiv(5), rhosts(5)

HISTORY
     The prm command appeared in clusterit 1.0. It is based on the  prm  command
     in IBM PSSP.

AUTHOR
     Prm was written by Tim Rightnour.

BUGS
     Some of the more advanced options, like the -P option, may not be available
     in some versions of rm(1).  Consult the rm(1) manpage on the remote host if
     you have problems.

				January 14, 2000			  PRM(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=prm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help