initial load of upstream version 1.06.32

[xmlrpc-c] / examples / auth_client.c

diff --git a/examples/auth_client.c b/examples/auth_client.c
new file mode 100644 (file)
index 0000000..dd6a2b4
--- /dev/null
+++ b/examples/auth_client.c
@@ -0,0 +1,80 @@
+/* A demonstration of using HTTP basic authentication with XML-RPC.
+**
+** In general, you shouldn't write XML-RPC servers which require basic
+** authenticaion. (Few XML-RPC clients are capable of it, and it's not part of
+** any standard.) Instead, you should pass any authentication information
+** as a regular XML-RPC parameter (or look into using SSL).
+**
+** But certain XML-RPC servers, including Zope, rely heavily on HTTP
+** basic authentication. Here's how to talk to them. */
+
+#include <stdlib.h>
+#include <stdio.h>
+
+#include <xmlrpc-c/base.h>
+#include <xmlrpc-c/client.h>
+
+#include "config.h"  /* information about this build environment */
+
+#define NAME       "XML-RPC C Auth Client"
+#define VERSION    "1.0"
+#define SERVER_URL "http://localhost:8080/RPC2"
+
+static void die_if_fault_occurred (xmlrpc_env *env)
+{
+    if (env->fault_occurred) {
+        fprintf(stderr, "XML-RPC Fault: %s (%d)\n",
+                env->fault_string, env->fault_code);
+        exit(1);
+    }
+}
+
+int 
+main(int           const argc, 
+     const char ** const argv ATTR_UNUSED) {
+
+    xmlrpc_env env;
+    xmlrpc_server_info * server;
+    xmlrpc_value * result;    
+    xmlrpc_int sum;
+    
+    if (argc-1 > 0) {
+        fprintf(stderr, "There are no arguments.  You specified %d", argc-1);
+        exit(1);
+    }
+
+    /* Start up our XML-RPC client library. */
+    xmlrpc_client_init(XMLRPC_CLIENT_NO_FLAGS, NAME, VERSION);
+    xmlrpc_env_init(&env);
+
+    /* Make a new object to represent our XML-RPC server. */
+    server = xmlrpc_server_info_new(&env, SERVER_URL);
+    die_if_fault_occurred(&env);
+
+    /* Set up our authentication information. */
+    xmlrpc_server_info_set_basic_auth(&env, server, "jrandom", "secret");
+    die_if_fault_occurred(&env);
+
+    result = 
+        xmlrpc_client_call_server(
+            &env, server, "sample.add", "(ii)", 
+            (xmlrpc_int32) 5, (xmlrpc_int32) 7);
+    die_if_fault_occurred(&env);
+
+    /* Dispose of our server object. */
+    xmlrpc_server_info_free(server);
+    
+    /* Get the authentication information and print it out. */
+    xmlrpc_read_int(&env, result, &sum);
+    die_if_fault_occurred(&env);
+    printf("The sum is %d\n", sum);
+    
+    /* Dispose of our result value. */
+    xmlrpc_DECREF(result);
+
+    /* Shut down our XML-RPC client library. */
+    xmlrpc_env_clean(&env);
+    xmlrpc_client_cleanup();
+
+    return 0;
+}