# # # patch "monotone.texi" # from [3891a89e070768a3b5e8cbbb969e57fb325d3abf] # to [862b961cb9b205f26ecd2efac43a885688b70862] # ============================================================ --- monotone.texi 3891a89e070768a3b5e8cbbb969e57fb325d3abf +++ monotone.texi 862b961cb9b205f26ecd2efac43a885688b70862 @@ -7894,6 +7894,12 @@ @section Automation send it to the remote server it will print a message to stderr and exit with code 1. address@hidden Notes + +On the server side the @code{get_remote_automate_permitted} hook has to be +configured to include every command which should be executable over this +interface. + @end table @item mtn automate remote @option{--remote-stdio-host=host} @var{command} @var{args-and-opts} @@ -7921,8 +7927,8 @@ @section Automation @item Purpose Permit a single @code{automate} command to be run against a database that is -being used to serve netsync connections, without having its output encoded -as by @code{automate stdio}. +being used to serve netsync connections, without having its input and output +encoded as by @code{automate stdio}. @item Input/Output Format @@ -7930,12 +7936,24 @@ @section Automation The output will be whatever output the remote command generates. +Remote diagnostic messages are written to standard error, prefixed either +with @code{mtn: remote error:}, @code{mtn: remote warning:} or address@hidden: remote message:} to make them distinguishable from local +diagnostics. Tickers are not supported over this interface. If you need +remote ticker support, please use @command{automate remote_stdio}. + @item Error Conditions -If the remote command returns an error code, will exit with code 1 and -print "Received remote error code N" to standard error, with "N" being +If the remote command returns a nonzero error code, will exit with code 1 and +print "received remote error code N" to standard error, with "N" being the remote error code. address@hidden Notes + +On the server side the @code{get_remote_automate_permitted} hook has to be +configured to include every command which should be executable over this +interface. + @end table @item mtn automate genkey @var{name} @var{passphrase}