lib/unixctl.h

   1 /*
   2  * Copyright (c) 2008, 2009 Nicira Networks.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at:
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #ifndef UNIXCTL_H
  18 #define UNIXCTL_H 1
  19
  20 #ifdef  __cplusplus
  21 extern "C" {
  22 #endif
  23
  24 /* Server for Unix domain socket control connection. */
  25 struct unixctl_server;
  26 int unixctl_server_create(const char *path, struct unixctl_server **);
  27 void unixctl_server_run(struct unixctl_server *);
  28 void unixctl_server_wait(struct unixctl_server *);
  29 void unixctl_server_destroy(struct unixctl_server *);
  30
  31 /* Client for Unix domain socket control connection. */
  32 struct unixctl_client;
  33 int unixctl_client_create(const char *path, struct unixctl_client **);
  34 void unixctl_client_destroy(struct unixctl_client *);
  35 int unixctl_client_transact(struct unixctl_client *,
  36                             const char *request,
  37                             int *reply_code, char **reply_body);
  38 const char *unixctl_client_target(const struct unixctl_client *);
  39
  40 /* Command registration. */
  41 struct unixctl_conn;
  42 typedef void unixctl_cb_func(struct unixctl_conn *,
  43                              const char *args, void *aux);
  44 void unixctl_command_register(const char *name,
  45                               unixctl_cb_func *cb, void *aux);
  46 void unixctl_command_reply(struct unixctl_conn *, int code,
  47                            const char *body);
  48
  49 #ifdef  __cplusplus
  50 }
  51 #endif
  52
  53 #endif /* unixctl.h */