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,
	    regardless 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 overwrit-
	    ten	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 clus-
	    ter.   The	format is the same as the -w option, a comma delimited
	    list of machine names.  This option	is silently  ignored  if  used
	    with the -w	option.

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.	Defaults 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 com-
       mand 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.0>

home | help