1
0
Fork 0
mirror of https://github.com/deltachat/deltachat-core.git synced 2025-10-04 18:29:19 +02:00
deltachat-core/cmdline/cmdline.h
2018-06-25 17:04:15 +02:00

51 lines
2 KiB
C

/*******************************************************************************
*
* Delta Chat Core
* Copyright (C) 2017 Björn Petersen
* Contact: r10s@b44t.com, http://b44t.com
*
* This program is free software: you can redistribute it and/or modify it under
* the terms of the GNU General Public License as published by the Free Software
* Foundation, either version 3 of the License, or (at your option) any later
* version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see http://www.gnu.org/licenses/ .
*
******************************************************************************/
#ifndef __DC_CMDLINE_H__
#define __DC_CMDLINE_H__
#ifdef __cplusplus
extern "C" {
#endif
/* Execute a simple command.
- This function is not neeed for the normal program flow but only for debugging purposes
to give users some special power to the database and to the connection.
- For security reasons, the first command must be `auth <password>`; once authorized, this is
is valid for _all_ exising and future mailbox objects. You can skip the authorisation process
by calling dc_cmdline_skip_auth()
- The returned result may contain multiple lines separated by `\n` and must be
free()'d if no longer needed.
- some commands may use dc_log_info() for additional output.
- The command `help` gives an overview */
char* dc_cmdline (dc_context_t*, const char* cmd);
/* If the command line authorisation (see dc_cmdline()) is not desired, eg. for a command line client,
you can skip this using dc_cmdline_skip_auth().*/
void dc_cmdline_skip_auth ();
#ifdef __cplusplus
} // /extern "C"
#endif
#endif // __DC_CMDLINE_H__