source4/smbd/service_task.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3
   4    helper functions for task based servers (nbtd, winbind etc)
   5
   6    Copyright (C) Andrew Tridgell 2005
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20 */
  21
  22 #include "includes.h"
  23 #include "process_model.h"
  24 #include "lib/events/events.h"
  25 #include "smbd/service.h"
  26 #include "smbd/service_task.h"
  27 #include "lib/messaging/irpc.h"
  28 #include "param/param.h"
  29
  30 /*
  31   terminate a task service
  32 */
  33 void task_server_terminate(struct task_server *task, const char *reason)
  34 {
  35         struct tevent_context *event_ctx = task->event_ctx;
  36         const struct model_ops *model_ops = task->model_ops;
  37         DEBUG(0,("task_server_terminate: [%s]\n", reason));
  38         model_ops->terminate(event_ctx, task->lp_ctx, reason);
  39
  40         /* don't free this above, it might contain the 'reason' being printed */
  41         talloc_free(task);
  42 }
  43
  44 /* used for the callback from the process model code */
  45 struct task_state {
  46         void (*task_init)(struct task_server *);
  47         const struct model_ops *model_ops;
  48 };
  49
  50
  51 /*
  52   called by the process model code when the new task starts up. This then calls
  53   the server specific startup code
  54 */
  55 static void task_server_callback(struct tevent_context *event_ctx,
  56                                  struct loadparm_context *lp_ctx,
  57                                  struct server_id server_id, void *private)
  58 {
  59         struct task_state *state = talloc_get_type(private, struct task_state);
  60         struct task_server *task;
  61
  62         task = talloc(event_ctx, struct task_server);
  63         if (task == NULL) return;
  64
  65         task->event_ctx = event_ctx;
  66         task->model_ops = state->model_ops;
  67         task->server_id = server_id;
  68         task->lp_ctx = lp_ctx;
  69
  70         task->msg_ctx = messaging_init(task,
  71                                        lp_messaging_path(task, task->lp_ctx),
  72                                        task->server_id,
  73                                        lp_iconv_convenience(task->lp_ctx),
  74                                        task->event_ctx);
  75         if (!task->msg_ctx) {
  76                 task_server_terminate(task, "messaging_init() failed");
  77                 return;
  78         }
  79
  80         state->task_init(task);
  81 }
  82
  83 /*
  84   startup a task based server
  85 */
  86 NTSTATUS task_server_startup(struct tevent_context *event_ctx,
  87                              struct loadparm_context *lp_ctx,
  88                              const char *service_name,
  89                              const struct model_ops *model_ops,
  90                              void (*task_init)(struct task_server *))
  91 {
  92         struct task_state *state;
  93
  94         state = talloc(event_ctx, struct task_state);
  95         NT_STATUS_HAVE_NO_MEMORY(state);
  96
  97         state->task_init = task_init;
  98         state->model_ops = model_ops;
  99
 100         model_ops->new_task(event_ctx, lp_ctx, service_name, task_server_callback, state);
 101
 102         return NT_STATUS_OK;
 103 }
 104
 105 /*
 106   setup a task title
 107 */
 108 void task_server_set_title(struct task_server *task, const char *title)
 109 {
 110         task->model_ops->set_title(task->event_ctx, title);
 111 }