udfOpenPipePrim()

Open a pipe to an external program from master processor.

Syntax

udfOpenPipePrim( udfHd, command ) ;

Type

AcuSolve User-Defined Function Client

Parameters

udfHd
The opaque handle (pointer) which was passed to the user function.
command (string)
Name and arguments of the external program.

Return Value

None

Description

This routine opens a client/server pipe to an external program, given by command. The external program must use the standard read/write calls to receive/send ASCII data. This function is the same as udfOpenPipe() except that only the master processor or subdomain opens the pipe, that is, only a single copy of the external program is executed. For example,
udfOpenPipePrim( udfHd, "rsh pelican usrPres.pl 4 1 0" ) ;

Errors

  • This routine expects a valid udfHd
  • May only be called from a multiplier function or mesh motion user-defined function.