Changeset 4860 for pjproject/trunk/pjlib/include/pj/sock.h

Timestamp:

Jun 19, 2014 5:07:12 AM (10 years ago)

Author:

riza

Message:

Re #1771: Implement run-time configuration to set specific socket option.

File:

• pjproject/trunk/pjlib/include/pj/sock.h (modified) (2 diffs)

pjproject/trunk/pjlib/include/pj/sock.h

@@ -617 +617 @@
 } pj_ip_mreq;
 
+/* Maximum number of socket options. */
+#define PJ_MAX_SOCKOPT_PARAMS 4
+
+/**
+ * Options to be set for the socket. 
+ */
+typedef struct pj_sockopt_params
+{
+    /* The number of options to be applied. */
+    unsigned cnt;
+
+    /* Array of options to be applied. */
+    struct {
+        /* The level at which the option is defined. */
+        int level;
+
+        /* Option name. */
+        int optname;
+
+        /* Pointer to the buffer in which the option is specified. */
+        void *optval;
+
+        /* Buffer size of the buffer pointed by optval. */
+        int optlen;
+    } options[PJ_MAX_SOCKOPT_PARAMS];
+} pj_sockopt_params;
 
 /*****************************************************************************
@@ -1306 +1332 @@
                                          int optlen);
 
+/**
+ * Set socket options associated with a socket. This method will apply all the 
+ * options specified, and ignore any errors that might be raised.
+ *
+ * @param sockfd        The socket descriptor.
+ * @param params        The socket options.
+ *
+ * @return              PJ_SUCCESS or the last error code. 
+ */
+PJ_DECL(pj_status_t) pj_sock_setsockopt_params( pj_sock_t sockfd,
+                                               const pj_sockopt_params *params);                                               
 
 /**