Skip to content

async command

Jump to bottom
Ryan Newington edited this page May 27, 2016 · 2 revisions

<async-command> (asynchronous command)

Asynchronous commands are used when a command may prompt the user for additional input after the command has executed, but before it exits. A common example of this is a password change command that executes and then prompts the user to enter their password. A [synchronous command|command] is not capable of responding to this input request, unless the command supports piping the information in from the command line.

Supported behaviours

Asynchronous commands support the following behaviours:

  • Providing additional input to the standard input (stdin) after a command has been executed. If the program being executed does not require additional user input, use a synchronous command instead

Asynchronous commands do not support:

  • Asynchronous command cannot be used to extract objects for import into FIM
  • Asynchronous commands cannot use exit or return codes to determine the success or failure of a command

Asynchronous commands support the following child elements;

The success-when element must appear last in the list of child elements. At least one send or send-when elements must be present in the <async-command> element.

Example

<async-command>
    <send-when expect="$ " timeout="5">/usr/local/bin/sudo /usr/bin/passwd {dn:$1}</send-when>
    <send-when expect="New Password: " timeout="5">{newpassword}</send-when>
    <send-when expect="assword: " timeout="5">{newpassword}</send-when>
    <success-when expect="password successfully changed for {dn:$1}" timeout="5"/>
</async-command>
Clone this wiki locally