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

FreeBSD Manual Pages

  
 
  

home | help
runpause(8)			   runtools			   runpause(8)

NAME
       runpause	- run a	program	after a	specified delay

SYNOPSIS
       runpause	[-hV] [-L label	] secs program [ args ...  ]

DESCRIPTION
       runpause	 sleeps	 for secs (or until interrupted	by a signal), and then
       runs program with any arguments given in	args.

       If secs is 0, runpause will pause forever, or until  interrupted	 by  a
       signal.

       If program does not contain a ``/'' slash character, runpause will per-
       form a shell-like search	for the	executable using the PATH variable  in
       the current environment.

OPTIONS
       -h     Help.  Print a brief usage message to stderr and exit.

       -L label
	      Label.   May  be used to provide label as	a distinctive command-
	      line marker for an instance of runpause, such as	for  reference
	      in ps(1) listings.  Otherwise, this option has no	effect.

       -V     Version.	Print the version number to stderr and exit.

EXAMPLES
       The runpause utility may	be used	to hack	a perpetrate(5)	service	out of
       what would normally be a	system initialization:

	      #!/bin/sh
	      exec 2>&1

	      if test ${1} = 'start' ; then
		# startup network:
		echo "starting network ..."
		ifconfig ...
		# maintain persistent state for	this service:
		exec runpause -L network 0 /bin/true
	      fi

	      if test ${1} = 'reset' ; then
		# take down network and	whatever depends on it:
		echo "resetting	network	..."
		...
	      fi

	      ### EOF

       The author does not recommend this sort of thing	and will never mention
       it again.

EXIT STATUS
       runpause	exits with one of the following	values:

       0      program  was  invoked and	completed successfully.	 In this case,
	      the exit code is returned	by the program,	rather	than  by  run-
	      pause itself.

       100    runpause	failed	because	 of  a usage error, such as an invalid
	      command-line option or argument.	In this	case, runpause	prints
	      a	brief error message and	usage help to stderr on	exit.

       111    runpause	failed	due to some system or resource error.  In this
	      case, runpause prints a brief diagnostic message	to  stderr  on
	      exit.

       1-127  program  was  invoked and	failed with its	own non-zero exit sta-
	      tus.

AUTHOR
       Wayne Marshall, http://b0llix.net/perp/

SEE ALSO
       runtools_intro(8), runargs(8), runargv0(8), runchoom(8),	 rundetach(8),
       rundeux(8),    runenv(8),    runfile(8),	   runlimit(8),	   runlock(8),
       runsession(8),	 runtool(8),	runtrap(8),    runuid(8),    perpd(8),
       perpetrate(5)

runtools-2.07			 January 2013			   runpause(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=runpause&sektion=8&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help