2 Unix SMB/CIFS implementation.
3 Infrastructure for async SMB client requests
4 Copyright (C) Volker Lendecke 2008
5 Copyright (C) Stefan Metzmacher 2011
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #ifndef _SMBXCLI_BASE_H_
22 #define _SMBXCLI_BASE_H_
25 struct smbXcli_session;
27 struct smb_trans_enc_state;
30 struct smb2_create_blobs;
32 struct smbXcli_conn *smbXcli_conn_create(TALLOC_CTX *mem_ctx,
34 const char *remote_name,
35 enum smb_signing_setting signing_state,
36 uint32_t smb1_capabilities,
37 struct GUID *client_guid,
38 uint32_t smb2_capabilities);
40 bool smbXcli_conn_is_connected(struct smbXcli_conn *conn);
41 void smbXcli_conn_disconnect(struct smbXcli_conn *conn, NTSTATUS status);
43 bool smbXcli_conn_has_async_calls(struct smbXcli_conn *conn);
45 bool smbXcli_conn_dfs_supported(struct smbXcli_conn *conn);
47 enum protocol_types smbXcli_conn_protocol(struct smbXcli_conn *conn);
48 bool smbXcli_conn_nt_smbs_supported(struct smbXcli_conn *conn);
49 bool smbXcli_conn_use_status32(struct smbXcli_conn *conn);
50 bool smbXcli_conn_use_large_files(struct smbXcli_conn *conn);
51 bool smbXcli_conn_use_unicode(struct smbXcli_conn *conn);
53 void smbXcli_conn_set_sockopt(struct smbXcli_conn *conn, const char *options);
54 const struct sockaddr_storage *smbXcli_conn_local_sockaddr(struct smbXcli_conn *conn);
55 const struct sockaddr_storage *smbXcli_conn_remote_sockaddr(struct smbXcli_conn *conn);
56 const char *smbXcli_conn_remote_name(struct smbXcli_conn *conn);
58 uint16_t smbXcli_conn_max_requests(struct smbXcli_conn *conn);
59 NTTIME smbXcli_conn_server_system_time(struct smbXcli_conn *conn);
60 const DATA_BLOB *smbXcli_conn_server_gss_blob(struct smbXcli_conn *conn);
61 const struct GUID *smbXcli_conn_server_guid(struct smbXcli_conn *conn);
63 struct tevent_req *smbXcli_conn_samba_suicide_send(TALLOC_CTX *mem_ctx,
64 struct tevent_context *ev,
65 struct smbXcli_conn *conn,
67 NTSTATUS smbXcli_conn_samba_suicide_recv(struct tevent_req *req);
68 NTSTATUS smbXcli_conn_samba_suicide(struct smbXcli_conn *conn,
71 void smbXcli_req_unset_pending(struct tevent_req *req);
72 bool smbXcli_req_set_pending(struct tevent_req *req);
74 uint32_t smb1cli_conn_capabilities(struct smbXcli_conn *conn);
75 uint32_t smb1cli_conn_max_xmit(struct smbXcli_conn *conn);
76 uint32_t smb1cli_conn_server_session_key(struct smbXcli_conn *conn);
77 const uint8_t *smb1cli_conn_server_challenge(struct smbXcli_conn *conn);
78 uint16_t smb1cli_conn_server_security_mode(struct smbXcli_conn *conn);
79 bool smb1cli_conn_server_readbraw(struct smbXcli_conn *conn);
80 bool smb1cli_conn_server_writebraw(struct smbXcli_conn *conn);
81 bool smb1cli_conn_server_lockread(struct smbXcli_conn *conn);
82 bool smb1cli_conn_server_writeunlock(struct smbXcli_conn *conn);
83 int smb1cli_conn_server_time_zone(struct smbXcli_conn *conn);
85 bool smb1cli_conn_activate_signing(struct smbXcli_conn *conn,
86 const DATA_BLOB user_session_key,
87 const DATA_BLOB response);
88 bool smb1cli_conn_check_signing(struct smbXcli_conn *conn,
89 const uint8_t *buf, uint32_t seqnum);
90 bool smb1cli_conn_signing_is_active(struct smbXcli_conn *conn);
92 void smb1cli_conn_set_encryption(struct smbXcli_conn *conn,
93 struct smb_trans_enc_state *es);
94 bool smb1cli_conn_encryption_on(struct smbXcli_conn *conn);
96 bool smb1cli_is_andx_req(uint8_t cmd);
97 size_t smb1cli_req_wct_ofs(struct tevent_req **reqs, int num_reqs);
99 uint16_t smb1cli_req_mid(struct tevent_req *req);
100 void smb1cli_req_set_mid(struct tevent_req *req, uint16_t mid);
102 uint32_t smb1cli_req_seqnum(struct tevent_req *req);
103 void smb1cli_req_set_seqnum(struct tevent_req *req, uint32_t seqnum);
105 struct smb1cli_req_expected_response {
110 struct tevent_req *smb1cli_req_create(TALLOC_CTX *mem_ctx,
111 struct tevent_context *ev,
112 struct smbXcli_conn *conn,
114 uint8_t additional_flags,
116 uint16_t additional_flags2,
117 uint16_t clear_flags2,
118 uint32_t timeout_msec,
120 struct smbXcli_tcon *tcon,
121 struct smbXcli_session *session,
122 uint8_t wct, uint16_t *vwv,
124 struct iovec *bytes_iov);
125 NTSTATUS smb1cli_req_chain_submit(struct tevent_req **reqs, int num_reqs);
127 struct tevent_req *smb1cli_req_send(TALLOC_CTX *mem_ctx,
128 struct tevent_context *ev,
129 struct smbXcli_conn *conn,
131 uint8_t additional_flags,
133 uint16_t additional_flags2,
134 uint16_t clear_flags2,
135 uint32_t timeout_msec,
137 struct smbXcli_tcon *tcon,
138 struct smbXcli_session *session,
139 uint8_t wct, uint16_t *vwv,
141 const uint8_t *bytes);
142 NTSTATUS smb1cli_req_recv(struct tevent_req *req,
148 uint32_t *pvwv_offset,
149 uint32_t *pnum_bytes,
151 uint32_t *pbytes_offset,
153 const struct smb1cli_req_expected_response *expected,
154 size_t num_expected);
156 struct tevent_req *smb1cli_trans_send(
157 TALLOC_CTX *mem_ctx, struct tevent_context *ev,
158 struct smbXcli_conn *conn, uint8_t cmd,
159 uint8_t additional_flags, uint8_t clear_flags,
160 uint16_t additional_flags2, uint16_t clear_flags2,
161 uint32_t timeout_msec,
163 struct smbXcli_tcon *tcon,
164 struct smbXcli_session *session,
165 const char *pipe_name, uint16_t fid, uint16_t function, int flags,
166 uint16_t *setup, uint8_t num_setup, uint8_t max_setup,
167 uint8_t *param, uint32_t num_param, uint32_t max_param,
168 uint8_t *data, uint32_t num_data, uint32_t max_data);
169 NTSTATUS smb1cli_trans_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
170 uint16_t *recv_flags2,
171 uint16_t **setup, uint8_t min_setup,
173 uint8_t **param, uint32_t min_param,
175 uint8_t **data, uint32_t min_data,
177 NTSTATUS smb1cli_trans(TALLOC_CTX *mem_ctx, struct smbXcli_conn *conn,
179 uint8_t additional_flags, uint8_t clear_flags,
180 uint16_t additional_flags2, uint16_t clear_flags2,
181 uint32_t timeout_msec,
183 struct smbXcli_tcon *tcon,
184 struct smbXcli_session *session,
185 const char *pipe_name, uint16_t fid, uint16_t function,
187 uint16_t *setup, uint8_t num_setup, uint8_t max_setup,
188 uint8_t *param, uint32_t num_param, uint32_t max_param,
189 uint8_t *data, uint32_t num_data, uint32_t max_data,
190 uint16_t *recv_flags2,
191 uint16_t **rsetup, uint8_t min_rsetup, uint8_t *num_rsetup,
192 uint8_t **rparam, uint32_t min_rparam, uint32_t *num_rparam,
193 uint8_t **rdata, uint32_t min_rdata, uint32_t *num_rdata);
195 struct tevent_req *smb1cli_echo_send(TALLOC_CTX *mem_ctx,
196 struct tevent_context *ev,
197 struct smbXcli_conn *conn,
198 uint32_t timeout_msec,
201 NTSTATUS smb1cli_echo_recv(struct tevent_req *req);
202 NTSTATUS smb1cli_echo(struct smbXcli_conn *conn, uint32_t timeout_msec,
203 uint16_t num_echos, DATA_BLOB data);
205 uint32_t smb2cli_conn_server_capabilities(struct smbXcli_conn *conn);
206 uint16_t smb2cli_conn_server_security_mode(struct smbXcli_conn *conn);
207 uint32_t smb2cli_conn_max_trans_size(struct smbXcli_conn *conn);
208 uint32_t smb2cli_conn_max_read_size(struct smbXcli_conn *conn);
209 uint32_t smb2cli_conn_max_write_size(struct smbXcli_conn *conn);
210 void smb2cli_conn_set_max_credits(struct smbXcli_conn *conn,
211 uint16_t max_credits);
213 struct tevent_req *smb2cli_req_create(TALLOC_CTX *mem_ctx,
214 struct tevent_context *ev,
215 struct smbXcli_conn *conn,
217 uint32_t additional_flags,
218 uint32_t clear_flags,
219 uint32_t timeout_msec,
220 struct smbXcli_tcon *tcon,
221 struct smbXcli_session *session,
222 const uint8_t *fixed,
226 void smb2cli_req_set_notify_async(struct tevent_req *req);
227 NTSTATUS smb2cli_req_compound_submit(struct tevent_req **reqs,
229 void smb2cli_req_set_credit_charge(struct tevent_req *req, uint16_t charge);
231 struct smb2cli_req_expected_response {
236 struct tevent_req *smb2cli_req_send(TALLOC_CTX *mem_ctx,
237 struct tevent_context *ev,
238 struct smbXcli_conn *conn,
240 uint32_t additional_flags,
241 uint32_t clear_flags,
242 uint32_t timeout_msec,
243 struct smbXcli_tcon *tcon,
244 struct smbXcli_session *session,
245 const uint8_t *fixed,
249 NTSTATUS smb2cli_req_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
251 const struct smb2cli_req_expected_response *expected,
252 size_t num_expected);
254 struct tevent_req *smbXcli_negprot_send(TALLOC_CTX *mem_ctx,
255 struct tevent_context *ev,
256 struct smbXcli_conn *conn,
257 uint32_t timeout_msec,
258 enum protocol_types min_protocol,
259 enum protocol_types max_protocol);
260 NTSTATUS smbXcli_negprot_recv(struct tevent_req *req);
261 NTSTATUS smbXcli_negprot(struct smbXcli_conn *conn,
262 uint32_t timeout_msec,
263 enum protocol_types min_protocol,
264 enum protocol_types max_protocol);
266 struct smbXcli_session *smbXcli_session_create(TALLOC_CTX *mem_ctx,
267 struct smbXcli_conn *conn);
268 struct smbXcli_session *smbXcli_session_copy(TALLOC_CTX *mem_ctx,
269 struct smbXcli_session *src);
270 NTSTATUS smbXcli_session_application_key(struct smbXcli_session *session,
273 void smbXcli_session_set_disconnect_expired(struct smbXcli_session *session);
274 uint16_t smb1cli_session_current_id(struct smbXcli_session* session);
275 void smb1cli_session_set_id(struct smbXcli_session* session,
276 uint16_t session_id);
277 NTSTATUS smb1cli_session_set_session_key(struct smbXcli_session *session,
278 const DATA_BLOB _session_key);
279 NTSTATUS smb1cli_session_protect_session_key(struct smbXcli_session *session);
280 uint8_t smb2cli_session_security_mode(struct smbXcli_session *session);
281 uint64_t smb2cli_session_current_id(struct smbXcli_session *session);
282 uint16_t smb2cli_session_get_flags(struct smbXcli_session *session);
283 void smb2cli_session_set_id_and_flags(struct smbXcli_session *session,
285 uint16_t session_flags);
286 void smb2cli_session_increment_channel_sequence(struct smbXcli_session *session);
287 NTSTATUS smb2cli_session_set_session_key(struct smbXcli_session *session,
288 const DATA_BLOB session_key,
289 const struct iovec *recv_iov);
290 NTSTATUS smb2cli_session_create_channel(TALLOC_CTX *mem_ctx,
291 struct smbXcli_session *session1,
292 struct smbXcli_conn *conn,
293 struct smbXcli_session **_session2);
294 NTSTATUS smb2cli_session_set_channel_key(struct smbXcli_session *session,
295 const DATA_BLOB channel_key,
296 const struct iovec *recv_iov);
298 struct smbXcli_tcon *smbXcli_tcon_create(TALLOC_CTX *mem_ctx);
299 uint16_t smb1cli_tcon_current_id(struct smbXcli_tcon *tcon);
300 void smb1cli_tcon_set_id(struct smbXcli_tcon *tcon, uint16_t tcon_id);
301 bool smb1cli_tcon_set_values(struct smbXcli_tcon *tcon,
303 uint16_t optional_support,
304 uint32_t maximal_access,
305 uint32_t guest_maximal_access,
307 const char *fs_type);
308 uint32_t smb2cli_tcon_current_id(struct smbXcli_tcon *tcon);
309 uint32_t smb2cli_tcon_capabilities(struct smbXcli_tcon *tcon);
310 void smb2cli_tcon_set_values(struct smbXcli_tcon *tcon,
311 struct smbXcli_session *session,
315 uint32_t capabilities,
316 uint32_t maximal_access);
318 struct tevent_req *smb2cli_session_setup_send(TALLOC_CTX *mem_ctx,
319 struct tevent_context *ev,
320 struct smbXcli_conn *conn,
321 uint32_t timeout_msec,
322 struct smbXcli_session *session,
324 uint32_t in_capabilities,
326 uint64_t in_previous_session_id,
327 const DATA_BLOB *in_security_buffer);
328 NTSTATUS smb2cli_session_setup_recv(struct tevent_req *req,
330 struct iovec **recv_iov,
331 DATA_BLOB *out_security_buffer);
333 struct tevent_req *smb2cli_logoff_send(TALLOC_CTX *mem_ctx,
334 struct tevent_context *ev,
335 struct smbXcli_conn *conn,
336 uint32_t timeout_msec,
337 struct smbXcli_session *session);
338 NTSTATUS smb2cli_logoff_recv(struct tevent_req *req);
339 NTSTATUS smb2cli_logoff(struct smbXcli_conn *conn,
340 uint32_t timeout_msec,
341 struct smbXcli_session *session);
343 struct tevent_req *smb2cli_create_send(
345 struct tevent_context *ev,
346 struct smbXcli_conn *conn,
347 uint32_t timeout_msec,
348 struct smbXcli_session *session,
349 struct smbXcli_tcon *tcon,
350 const char *filename,
351 uint8_t oplock_level, /* SMB2_OPLOCK_LEVEL_* */
352 uint32_t impersonation_level, /* SMB2_IMPERSONATION_* */
353 uint32_t desired_access,
354 uint32_t file_attributes,
355 uint32_t share_access,
356 uint32_t create_disposition,
357 uint32_t create_options,
358 struct smb2_create_blobs *blobs);
359 NTSTATUS smb2cli_create_recv(struct tevent_req *req,
360 uint64_t *fid_persistent,
361 uint64_t *fid_volatile);
362 NTSTATUS smb2cli_create(struct smbXcli_conn *conn,
363 uint32_t timeout_msec,
364 struct smbXcli_session *session,
365 struct smbXcli_tcon *tcon,
366 const char *filename,
367 uint8_t oplock_level, /* SMB2_OPLOCK_LEVEL_* */
368 uint32_t impersonation_level, /* SMB2_IMPERSONATION_* */
369 uint32_t desired_access,
370 uint32_t file_attributes,
371 uint32_t share_access,
372 uint32_t create_disposition,
373 uint32_t create_options,
374 struct smb2_create_blobs *blobs,
375 uint64_t *fid_persistent,
376 uint64_t *fid_volatile);
378 struct tevent_req *smb2cli_close_send(TALLOC_CTX *mem_ctx,
379 struct tevent_context *ev,
380 struct smbXcli_conn *conn,
381 uint32_t timeout_msec,
382 struct smbXcli_session *session,
383 struct smbXcli_tcon *tcon,
385 uint64_t fid_persistent,
386 uint64_t fid_volatile);
387 NTSTATUS smb2cli_close_recv(struct tevent_req *req);
388 NTSTATUS smb2cli_close(struct smbXcli_conn *conn,
389 uint32_t timeout_msec,
390 struct smbXcli_session *session,
391 struct smbXcli_tcon *tcon,
393 uint64_t fid_persistent,
394 uint64_t fid_volatile);
396 struct tevent_req *smb2cli_read_send(TALLOC_CTX *mem_ctx,
397 struct tevent_context *ev,
398 struct smbXcli_conn *conn,
399 uint32_t timeout_msec,
400 struct smbXcli_session *session,
401 struct smbXcli_tcon *tcon,
404 uint64_t fid_persistent,
405 uint64_t fid_volatile,
406 uint64_t minimum_count,
407 uint64_t remaining_bytes);
408 NTSTATUS smb2cli_read_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
409 uint8_t **data, uint32_t *data_length);
410 NTSTATUS smb2cli_read(struct smbXcli_conn *conn,
411 uint32_t timeout_msec,
412 struct smbXcli_session *session,
413 struct smbXcli_tcon *tcon,
416 uint64_t fid_persistent,
417 uint64_t fid_volatile,
418 uint64_t minimum_count,
419 uint64_t remaining_bytes,
422 uint32_t *data_length);
424 struct tevent_req *smb2cli_write_send(TALLOC_CTX *mem_ctx,
425 struct tevent_context *ev,
426 struct smbXcli_conn *conn,
427 uint32_t timeout_msec,
428 struct smbXcli_session *session,
429 struct smbXcli_tcon *tcon,
432 uint64_t fid_persistent,
433 uint64_t fid_volatile,
434 uint32_t remaining_bytes,
436 const uint8_t *data);
437 NTSTATUS smb2cli_write_recv(struct tevent_req *req);
438 NTSTATUS smb2cli_write(struct smbXcli_conn *conn,
439 uint32_t timeout_msec,
440 struct smbXcli_session *session,
441 struct smbXcli_tcon *tcon,
444 uint64_t fid_persistent,
445 uint64_t fid_volatile,
446 uint32_t remaining_bytes,
448 const uint8_t *data);
450 struct tevent_req *smb2cli_flush_send(TALLOC_CTX *mem_ctx,
451 struct tevent_context *ev,
452 struct smbXcli_conn *conn,
453 uint32_t timeout_msec,
454 struct smbXcli_session *session,
455 struct smbXcli_tcon *tcon,
456 uint64_t fid_persistent,
457 uint64_t fid_volatile);
458 NTSTATUS smb2cli_flush_recv(struct tevent_req *req);
459 NTSTATUS smb2cli_flush(struct smbXcli_conn *conn,
460 uint32_t timeout_msec,
461 struct smbXcli_session *session,
462 struct smbXcli_tcon *tcon,
463 uint64_t fid_persistent,
464 uint64_t fid_volatile);
466 struct tevent_req *smb2cli_set_info_send(TALLOC_CTX *mem_ctx,
467 struct tevent_context *ev,
468 struct smbXcli_conn *conn,
469 uint32_t timeout_msec,
470 struct smbXcli_session *session,
471 struct smbXcli_tcon *tcon,
472 uint8_t in_info_type,
473 uint8_t in_file_info_class,
474 const DATA_BLOB *in_input_buffer,
475 uint32_t in_additional_info,
476 uint64_t in_fid_persistent,
477 uint64_t in_fid_volatile);
478 NTSTATUS smb2cli_set_info_recv(struct tevent_req *req);
479 NTSTATUS smb2cli_set_info(struct smbXcli_conn *conn,
480 uint32_t timeout_msec,
481 struct smbXcli_session *session,
482 struct smbXcli_tcon *tcon,
483 uint8_t in_info_type,
484 uint8_t in_file_info_class,
485 const DATA_BLOB *in_input_buffer,
486 uint32_t in_additional_info,
487 uint64_t in_fid_persistent,
488 uint64_t in_fid_volatile);
490 struct tevent_req *smb2cli_query_info_send(TALLOC_CTX *mem_ctx,
491 struct tevent_context *ev,
492 struct smbXcli_conn *conn,
493 uint32_t timeout_msec,
494 struct smbXcli_session *session,
495 struct smbXcli_tcon *tcon,
496 uint8_t in_info_type,
497 uint8_t in_file_info_class,
498 uint32_t in_max_output_length,
499 const DATA_BLOB *in_input_buffer,
500 uint32_t in_additional_info,
502 uint64_t in_fid_persistent,
503 uint64_t in_fid_volatile);
504 NTSTATUS smb2cli_query_info_recv(struct tevent_req *req,
506 DATA_BLOB *out_output_buffer);
507 NTSTATUS smb2cli_query_info(struct smbXcli_conn *conn,
508 uint32_t timeout_msec,
509 struct smbXcli_session *session,
510 struct smbXcli_tcon *tcon,
511 uint8_t in_info_type,
512 uint8_t in_file_info_class,
513 uint32_t in_max_output_length,
514 const DATA_BLOB *in_input_buffer,
515 uint32_t in_additional_info,
517 uint64_t in_fid_persistent,
518 uint64_t in_fid_volatile,
520 DATA_BLOB *out_output_buffer);
522 struct tevent_req *smb2cli_query_directory_send(TALLOC_CTX *mem_ctx,
523 struct tevent_context *ev,
524 struct smbXcli_conn *conn,
525 uint32_t timeout_msec,
526 struct smbXcli_session *session,
527 struct smbXcli_tcon *tcon,
531 uint64_t fid_persistent,
532 uint64_t fid_volatile,
534 uint32_t outbuf_len);
535 NTSTATUS smb2cli_query_directory_recv(struct tevent_req *req,
538 uint32_t *data_length);
539 NTSTATUS smb2cli_query_directory(struct smbXcli_conn *conn,
540 uint32_t timeout_msec,
541 struct smbXcli_session *session,
542 struct smbXcli_tcon *tcon,
546 uint64_t fid_persistent,
547 uint64_t fid_volatile,
552 uint32_t *data_length);
554 struct tevent_req *smb2cli_ioctl_send(TALLOC_CTX *mem_ctx,
555 struct tevent_context *ev,
556 struct smbXcli_conn *conn,
557 uint32_t timeout_msec,
558 struct smbXcli_session *session,
559 struct smbXcli_tcon *tcon,
560 uint64_t in_fid_persistent,
561 uint64_t in_fid_volatile,
562 uint32_t in_ctl_code,
563 uint32_t in_max_input_length,
564 const DATA_BLOB *in_input_buffer,
565 uint32_t in_max_output_length,
566 const DATA_BLOB *in_output_buffer,
568 NTSTATUS smb2cli_ioctl_recv(struct tevent_req *req,
570 DATA_BLOB *out_input_buffer,
571 DATA_BLOB *out_output_buffer);
572 NTSTATUS smb2cli_ioctl(struct smbXcli_conn *conn,
573 uint32_t timeout_msec,
574 struct smbXcli_session *session,
575 struct smbXcli_tcon *tcon,
576 uint64_t in_fid_persistent,
577 uint64_t in_fid_volatile,
578 uint32_t in_ctl_code,
579 uint32_t in_max_input_length,
580 const DATA_BLOB *in_input_buffer,
581 uint32_t in_max_output_length,
582 const DATA_BLOB *in_output_buffer,
585 DATA_BLOB *out_input_buffer,
586 DATA_BLOB *out_output_buffer);
588 struct tevent_req *smb2cli_echo_send(TALLOC_CTX *mem_ctx,
589 struct tevent_context *ev,
590 struct smbXcli_conn *conn,
591 uint32_t timeout_msec);
592 NTSTATUS smb2cli_echo_recv(struct tevent_req *req);
593 NTSTATUS smb2cli_echo(struct smbXcli_conn *conn,
594 uint32_t timeout_msec);
596 #endif /* _SMBXCLI_BASE_H_ */