Edit

waitfor

  • Article

Sends or waits for a signal on a system. This command is used to synchronize computers across a network.

Syntax

waitfor [/s <computer> [/u [<domain>\]<user> [/p [<password>]]]] /si <signalname>
waitfor [/t <timeout>] <signalname>

Parameters

Parameter Description
/s <computer> Specifies the name or IP address of a remote computer (don't use backslashes). The default is the local computer. This parameter applies to all files and folders specified in the command. If you don't use this parameter, the signal is broadcast to all the systems in a domain. If you do use this parameter, the signal is sent only to the specified system.
/u [<domain>]<user> Runs the script using the credentials of the specified user account. By default, waitfor uses the current user's credentials.
/p [\<password>] Specifies the password of the user account that is specified in the /u parameter.
/si Sends the specified signal across the network. This parameter also lets you manually activate a signal.
/t <timeout> Specifies the number of seconds to wait for a signal. By default, waitfor waits indefinitely.
<signalname> Specifies the signal that waitfor waits for or sends. This parameter isn't case-sensitive and can't exceed 225 characters. Valid characters include a-z, A-Z, 0-9, and the ASCII extended character set (128-255).
/? Displays help at the command prompt.

Remarks

  • You can run multiple instances of waitfor on a single computer, but each instance of waitfor must wait for a different signal. Only one instance of waitfor can wait for a given signal on a given computer.

  • Computers can only receive signals if they are in the same domain as the computer sending the signal.

  • You can use this command when you test software builds. For example, the compiling computer can send a signal to several computers running waitfor after the compile has completed successfully. On receipt of the signal, the batch file that includes waitfor can instruct the computers to immediately start installing software or running tests on the compiled build.

Examples

To wait until the espresso\build007 signal is received, type:

waitfor espresso\build007

By default, waitfor waits indefinitely for a signal.

To wait 10 seconds for the espresso\compile007 signal to be received before timing out, type:

waitfor /t 10 espresso\build007

To manually activate the espresso\build007 signal, type:

waitfor /si espresso\build007