source3/rpc_server/rpc_pipes.h

   1 /*
   2    Unix SMB/Netbios implementation.
   3    RPC Server Headers
   4    Copyright (C) Andrew Tridgell 1992-1997
   5    Copyright (C) Luke Kenneth Casson Leighton 1996-1997
   6    Copyright (C) Paul Ashton 1997
   7    Copyright (C) Jeremy Allison 2000-2004
   8    Copyright (C) Simo Sorce 2010-2011
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 3 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  22 */
  23
  24 #ifndef _RPC_PIPES_H_
  25 #define _RPC_PIPES_H_
  26
  27 #include "librpc/rpc/dcerpc.h"
  28
  29 struct dcesrv_ep_entry_list;
  30 struct tsocket_address;
  31 struct pipes_struct;
  32 struct dcesrv_context;
  33
  34 /*
  35  * DCE/RPC-specific samba-internal-specific handling of data on
  36  * NamedPipes.
  37  */
  38 struct pipes_struct {
  39         struct pipes_struct *next, *prev;
  40
  41         const struct tsocket_address *local_address;
  42         const struct tsocket_address *remote_address;
  43
  44         enum dcerpc_transport_t transport;
  45
  46         struct auth_session_info *session_info;
  47         struct messaging_context *msg_ctx;
  48
  49         struct dcesrv_ep_entry_list *ep_entries;
  50
  51         struct pipe_auth_data auth;
  52
  53         /*
  54          * Set to true when an RPC bind has been done on this pipe.
  55          */
  56         bool pipe_bound;
  57
  58         /*
  59          * Set the DCERPC_FAULT to return.
  60          */
  61         int fault_state;
  62
  63         /* This context is used for PDU data and is freed between each pdu.
  64                 Don't use for pipe state storage. */
  65         TALLOC_CTX *mem_ctx;
  66
  67         /* handle database to use on this pipe. */
  68         struct dcesrv_call_state *dce_call;
  69
  70         /* call id retrieved from the pdu header */
  71         uint32_t call_id;
  72
  73         /* operation number retrieved from the rpc header */
  74         uint16_t opnum;
  75
  76         /* private data for the interface implementation */
  77         void *private_data;
  78
  79 };
  80
  81 int make_base_pipes_struct(TALLOC_CTX *mem_ctx,
  82                            struct messaging_context *msg_ctx,
  83                            const char *pipe_name,
  84                            enum dcerpc_transport_t transport,
  85                            const struct tsocket_address *remote_address,
  86                            const struct tsocket_address *local_address,
  87                            struct pipes_struct **_p);
  88
  89 bool check_open_pipes(void);
  90 size_t num_pipe_handles(void);
  91
  92 bool create_policy_hnd(struct pipes_struct *p,
  93                         struct policy_handle *hnd,
  94                         uint8_t handle_type,
  95                         void *data_ptr);
  96
  97 void *_find_policy_by_hnd(struct pipes_struct *p,
  98                           const struct policy_handle *hnd,
  99                           uint8_t handle_type,
 100                           NTSTATUS *pstatus);
 101 #define find_policy_by_hnd(_p, _hnd, _hnd_type, _type, _pstatus) \
 102         (_type *)_find_policy_by_hnd((_p), (_hnd), (_hnd_type), (_pstatus));
 103
 104 bool close_policy_hnd(struct pipes_struct *p, struct policy_handle *hnd);
 105 void close_policy_by_pipe(struct pipes_struct *p);
 106 bool pipe_access_check(struct pipes_struct *p);
 107
 108 #endif /* _RPC_PIPES_H_ */