• Reference
• /
• Functions
• /
• remoteclassesmatching

remoteclassesmatching

This function is only available in CFEngine Enterprise.

Prototype:remoteclassesmatching(regex, server, encrypt, prefix)

Return type:boolean

Description: Reads persistent classes matching regular expressionregexfrom a remote CFEngine serverserver and adds them into local context withprefixprefix.

The return value is true (sets the class) if communication with the server wassuccessful and classes were populated in the current bundle.

This function contacts a remotecf-serverd and requests access to definedpersistent classes on that system. Access must be granted by making anaccess promise withresource_type set tocontext.

Arguments:

• regex: regular expression - Regular expression - in the range:.*
• server:string - Server name or address - in the range:.*
• encrypt: - Use encryption - one of
  • true
  • false
  • yes
  • no
  • on
  • off
• prefix:string - Return class prefix - in the range:[a-zA-Z0-9_$(){}\[\].:]+

Example:

"succeeded"expression=>remoteclassesmatching("regex","server","yes","myprefix");

Notes: Note that this function assumes that you have already performed asuccessful key exchange between systems, (e.g. using either a remotecopy orcf-runagent connection). It contains no mechanism for trustestablishment and will fail if there is no trust relationshippre-established.

See also:hubknowledge(),remotescalar(),hostswithclass()

Still need help?

Chat

Ask a question on Github

Mailing list