404 Not Found

PATH: usr / include / mysql / server / private

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; version 2 of the License.

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, write to the Free Software Foundation, Inc.,
   51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA */

/*
 * Vio Lite.
 * Purpose: include file for Vio that will work with C and C++
 */

#ifndef vio_violite_h_
#define	vio_violite_h_

#include "my_net.h"   /* needed because of struct in_addr */
#include <mysql/psi/mysql_socket.h>

/* Simple vio interface in C;  The functions are implemented in violite.c */

#ifdef	__cplusplus
extern "C" {
#endif /* __cplusplus */

#ifdef __cplusplus
typedef struct st_vio Vio;
#endif /* __cplusplus */

enum enum_vio_type
{
  VIO_CLOSED, VIO_TYPE_TCPIP, VIO_TYPE_SOCKET, VIO_TYPE_NAMEDPIPE,
  VIO_TYPE_SSL
  /* see also vio_type_names[] */
};

enum enum_vio_state
{
  VIO_STATE_NOT_INITIALIZED, VIO_STATE_ACTIVE, VIO_STATE_SHUTDOWN,
  VIO_STATE_CLOSED
};

#define FIRST_VIO_TYPE VIO_CLOSED
#define LAST_VIO_TYPE VIO_TYPE_SSL

/**
  VIO I/O events.
*/
enum enum_vio_io_event
{
  VIO_IO_EVENT_READ,
  VIO_IO_EVENT_WRITE,
  VIO_IO_EVENT_CONNECT
};

struct vio_keepalive_opts
{
  int interval;
  int idle;
  int probes;
};

#define VIO_TLSv1_0   1
#define VIO_TLSv1_1   2
#define VIO_TLSv1_2   4
#define VIO_TLSv1_3   8

#define VIO_LOCALHOST 1U                        /* a localhost connection */
#define VIO_BUFFERED_READ 2U                    /* use buffered read */
#define VIO_READ_BUFFER_SIZE 16384U             /* size of read buffer */
#define VIO_DESCRIPTION_SIZE 30                 /* size of description */

Vio* vio_new(my_socket sd, enum enum_vio_type type, uint flags);
Vio*  mysql_socket_vio_new(MYSQL_SOCKET mysql_socket, enum enum_vio_type type, uint flags);
#ifdef _WIN32
Vio* vio_new_win32pipe(HANDLE hPipe);
#else
#define HANDLE void *
#endif /* _WIN32 */

void	vio_delete(Vio* vio);
int	vio_close(Vio* vio);
my_bool vio_reset(Vio* vio, enum enum_vio_type type,
                  my_socket sd, void *ssl, uint flags);
size_t	vio_read(Vio *vio, uchar *	buf, size_t size);
size_t  vio_read_buff(Vio *vio, uchar * buf, size_t size);
size_t	vio_write(Vio *vio, const uchar * buf, size_t size);
int	vio_blocking(Vio *vio, my_bool onoff, my_bool *old_mode);
my_bool	vio_is_blocking(Vio *vio);
/* setsockopt TCP_NODELAY at IPPROTO_TCP level, when possible */
int vio_nodelay(Vio *vio, my_bool on);
int	vio_fastsend(Vio *vio);
/* setsockopt SO_KEEPALIVE at SOL_SOCKET level, when possible */
int	vio_keepalive(Vio *vio, my_bool	onoff);
int	vio_set_keepalive_options(Vio * vio, const struct vio_keepalive_opts *opts);
/* Whenever we should retry the last read/write operation. */
my_bool	vio_should_retry(Vio *vio);
/* Check that operation was timed out */
my_bool vio_was_timeout(Vio *vio);
/* Short text description of the socket for those, who are curious.. */
const char* vio_description(Vio *vio);
/* Return the type of the connection */
enum enum_vio_type vio_type(Vio* vio);
/* Return last error number */
int	vio_errno(Vio*vio);
/* Get socket number */
my_socket vio_fd(Vio*vio);
/* Remote peer's address and name in text form */
my_bool vio_peer_addr(Vio *vio, char *buf, uint16 *port, size_t buflen);
/* Wait for an I/O event notification. */
int vio_io_wait(Vio *vio, enum enum_vio_io_event event, int timeout);
my_bool vio_is_connected(Vio *vio);
ssize_t vio_pending(Vio *vio);
/* Set timeout for a network operation. */
extern int vio_timeout(Vio *vio, uint which, int timeout_sec);
extern void vio_set_wait_callback(void (*before_wait)(void),
                                void (*after_wait)(void));
/* Connect to a peer. */
my_bool vio_socket_connect(Vio *vio, struct sockaddr *addr, socklen_t len,
                           int timeout);

void vio_get_normalized_ip(const struct sockaddr *src, size_t src_length, struct sockaddr *dst);

my_bool vio_get_normalized_ip_string(const struct sockaddr *addr, size_t addr_length,
                                     char *ip_string, size_t ip_string_size);

my_bool vio_is_no_name_error(int err_code);

int vio_getnameinfo(const struct sockaddr *sa,
                    char *hostname, size_t hostname_size,
                    char *port, size_t port_size,
                    int flags);

#ifdef HAVE_OPENSSL
/* apple deprecated openssl in MacOSX Lion */
#ifdef __APPLE__
#pragma GCC diagnostic ignored "-Wdeprecated-declarations"
#endif

#define HEADER_DES_LOCL_H dummy_something
#define YASSL_MYSQL_COMPATIBLE
#ifndef YASSL_PREFIX
#define YASSL_PREFIX
#endif
/* Set yaSSL to use same type as MySQL do for socket handles */
typedef my_socket YASSL_SOCKET_T;
#define YASSL_SOCKET_T_DEFINED
#define template _template /* bug in WolfSSL 4.4.0, see also my_crypt.cc */
#include <openssl/ssl.h>
#undef template
#include <openssl/err.h>
#ifdef DEPRECATED
#undef DEPRECATED
#endif

enum enum_ssl_init_error
{
  SSL_INITERR_NOERROR= 0, SSL_INITERR_CERT, SSL_INITERR_KEY,
  SSL_INITERR_NOMATCH, SSL_INITERR_BAD_PATHS, SSL_INITERR_CIPHERS,
  SSL_INITERR_MEMFAIL, SSL_INITERR_DH, SSL_INITERR_PROTOCOL,
  SSL_INITERR_LASTERR
};
const char* sslGetErrString(enum enum_ssl_init_error err);

struct st_VioSSLFd
{
  SSL_CTX *ssl_context;
};

int sslaccept(struct st_VioSSLFd*, Vio *, long timeout, unsigned long *errptr);
int sslconnect(struct st_VioSSLFd*, Vio *, long timeout, unsigned long *errptr);

void vio_check_ssl_init();

struct st_VioSSLFd
*new_VioSSLConnectorFd(const char *key_file, const char *cert_file,
		       const char *ca_file,  const char *ca_path,
		       const char *cipher, enum enum_ssl_init_error *error,
                       const char *crl_file, const char *crl_path);
struct st_VioSSLFd
*new_VioSSLAcceptorFd(const char *key_file, const char *cert_file,
		      const char *ca_file,const char *ca_path,
		      const char *cipher, enum enum_ssl_init_error *error,
		      const char *crl_file, const char *crl_path,
		      ulonglong tls_version);
void free_vio_ssl_acceptor_fd(struct st_VioSSLFd *fd);
#endif /* HAVE_OPENSSL */

void vio_end(void);

const char *vio_type_name(enum enum_vio_type vio_type, size_t *len);

#ifdef	__cplusplus
}
#endif

#if !defined(DONT_MAP_VIO)
#define vio_delete(vio) 			(vio)->viodelete(vio)
#define vio_errno(vio)	 			(vio)->vioerrno(vio)
#define vio_read(vio, buf, size)                ((vio)->read)(vio,buf,size)
#define vio_write(vio, buf, size)               ((vio)->write)(vio, buf, size)
#define vio_blocking(vio, set_blocking_mode, old_mode)\
 	(vio)->vioblocking(vio, set_blocking_mode, old_mode)
#define vio_is_blocking(vio) 			(vio)->is_blocking(vio)
#define vio_fastsend(vio)			(vio)->fastsend(vio)
#define vio_keepalive(vio, set_keep_alive)	(vio)->viokeepalive(vio, set_keep_alive)
#define vio_should_retry(vio) 			(vio)->should_retry(vio)
#define vio_was_timeout(vio)                    (vio)->was_timeout(vio)
#define vio_close(vio)				((vio)->vioclose)(vio)
#define vio_shutdown(vio,how)			((vio)->shutdown)(vio,how)
#define vio_peer_addr(vio, buf, prt, buflen)	(vio)->peer_addr(vio, buf, prt, buflen)
#define vio_io_wait(vio, event, timeout)        (vio)->io_wait(vio, event, timeout)
#define vio_is_connected(vio)                   (vio)->is_connected(vio)
#endif /* !defined(DONT_MAP_VIO) */

#ifdef _WIN32

/* shutdown(2) flags */
#ifndef SHUT_RD
#define SHUT_RD SD_RECEIVE
#endif

#endif

/* This enumerator is used in parser - should be always visible */
enum SSL_type
{
  SSL_TYPE_NOT_SPECIFIED= -1,
  SSL_TYPE_NONE,
  SSL_TYPE_ANY,
  SSL_TYPE_X509,
  SSL_TYPE_SPECIFIED
};

/* HFTODO - hide this if we don't want client in embedded server */
/* This structure is for every connection on both sides */
struct st_vio
{
  MYSQL_SOCKET  mysql_socket;     /* Instrumented socket */
  my_bool		localhost;	/* Are we from localhost? */
  int			fcntl_mode;	/* Buffered fcntl(sd,F_GETFL) */
  struct sockaddr_storage local;	/* Local internet address */
  struct sockaddr_storage remote;	/* Remote internet address */
  enum enum_vio_type	type;		/* Type of connection */
  enum enum_vio_state	state;		/* State of the connection */
  const char		*desc;		/* String description */
  char                  *read_buffer;   /* buffer for vio_read_buff */
  char                  *read_pos;      /* start of unfetched data in the
                                           read buffer */
  char                  *read_end;      /* end of unfetched data */
  int                   read_timeout;   /* Timeout value (ms) for read ops. */
  int                   write_timeout;  /* Timeout value (ms) for write ops. */
  /* function pointers. They are similar for socket/SSL/whatever */
  void    (*viodelete)(Vio*);
  int     (*vioerrno)(Vio*);
  size_t  (*read)(Vio*, uchar *, size_t);
  size_t  (*write)(Vio*, const uchar *, size_t);
  int     (*timeout)(Vio*, uint, my_bool);
  int     (*vioblocking)(Vio*, my_bool, my_bool *);
  my_bool (*is_blocking)(Vio*);
  int     (*viokeepalive)(Vio*, my_bool);
  int     (*fastsend)(Vio*);
  my_bool (*peer_addr)(Vio*, char *, uint16*, size_t);
  void    (*in_addr)(Vio*, struct sockaddr_storage*);
  my_bool (*should_retry)(Vio*);
  my_bool (*was_timeout)(Vio*);
  int     (*vioclose)(Vio*);
  my_bool (*is_connected)(Vio*);
  int (*shutdown)(Vio *, int);
  my_bool (*has_data) (Vio*);
  int (*io_wait)(Vio*, enum enum_vio_io_event, int);
  my_bool (*connect)(Vio*, struct sockaddr *, socklen_t, int);
#ifdef HAVE_OPENSSL
  void	  *ssl_arg;
#endif
#ifdef _WIN32
  HANDLE hPipe;
  OVERLAPPED overlapped;
  int shutdown_flag;
  void *tp_ctx; /* threadpool context */
#endif
};
#endif /* vio_violite_h_ */

[+] ..
[-] sp_head.h [edit]
[-] lf.h [edit]
[-] sql_type_json.h [edit]
[-] field.h [edit]
[+] providers
[-] sql_schema.h [edit]
[-] rpl_filter.h [edit]
[-] item_jsonfunc.h [edit]
[-] my_json_writer.h [edit]
[-] service_versions.h [edit]
[-] mdl.h [edit]
[-] wsrep_utils.h [edit]
[-] my_rdtsc.h [edit]
[-] item_xmlfunc.h [edit]
[-] myisamchk.h [edit]
[-] wsrep.h [edit]
[-] sql_basic_types.h [edit]
[-] wsrep_high_priority_service.h [edit]
[-] wsrep_event_service.h [edit]
[-] sql_digest.h [edit]
[-] sql_analyze_stmt.h [edit]
[-] my_rnd.h [edit]
[-] proxy_protocol.h [edit]
[-] field_comp.h [edit]
[-] pfs_socket_provider.h [edit]
[-] my_virtual_mem.h [edit]
[-] unireg.h [edit]
[-] charset_collations.h [edit]
[-] sql_insert.h [edit]
[-] embedded_priv.h [edit]
[-] rpl_reporting.h [edit]
[-] authors.h [edit]
[-] sql_type_fixedbin.h [edit]
[-] sql_profile.h [edit]
[-] pfs_stage_provider.h [edit]
[-] sql_error.h [edit]
[-] sql_udf.h [edit]
[-] sp_pcontext.h [edit]
[-] lex_token.h [edit]
[-] sql_partition_admin.h [edit]
[-] uniques.h [edit]
[-] sql_audit.h [edit]
[-] sql_connect.h [edit]
[-] privilege.h [edit]
[-] tztime.h [edit]
[-] sql_type_fixedbin_storage.h [edit]
[-] wsrep_thd.h [edit]
[-] probes_mysql_dtrace.h [edit]
[-] pfs_thread_provider.h [edit]
[-] spatial.h [edit]
[+] atomic
[-] sql_manager.h [edit]
[-] sql_string.h [edit]
[-] my_service_manager.h [edit]
[-] sp_instr.h [edit]
[-] filesort.h [edit]
[-] backup.h [edit]
[-] sql_lifo_buffer.h [edit]
[-] debug_sync.h [edit]
[-] sql_type_int.h [edit]
[-] scope.h [edit]
[-] probes_mysql_nodtrace.h [edit]
[-] rijndael.h [edit]
[-] rpl_record.h [edit]
[-] transaction.h [edit]
[-] sql_type_real.h [edit]
[-] wsrep_on.h [edit]
[-] my_compare.h [edit]
[-] ddl_log.h [edit]
[-] hostname.h [edit]
[-] datadict.h [edit]
[-] key.h [edit]
[-] protocol.h [edit]
[-] config.h [edit]
[-] my_tracker.h [edit]
[-] threadpool_winsockets.h [edit]
[-] mysys_err.h [edit]
[-] ha_partition.h [edit]
[-] sql_plugin.h [edit]
[-] sql_rename.h [edit]
[-] sql_table.h [edit]
[-] sql_select.h [edit]
[-] rpl_parallel.h [edit]
[-] wsrep_priv.h [edit]
[-] my_md5.h [edit]
[-] wsrep_storage_service.h [edit]
[-] procedure.h [edit]
[-] my_nosys.h [edit]
[-] lex.h [edit]
[-] lex_hash.h [edit]
[-] wsrep_xid.h [edit]
[-] thr_timer.h [edit]
[-] sql_i_s.h [edit]
[-] pfs_file_provider.h [edit]
[-] wsrep_mysqld.h [edit]
[-] pfs_memory_provider.h [edit]
[-] myisammrg.h [edit]
[-] sql_bitmap.h [edit]
[-] wsrep_var.h [edit]
[-] sql_view.h [edit]
[-] sql_const.h [edit]
[-] log_slow.h [edit]
[-] sql_tvc.h [edit]
[-] hash_filo.h [edit]
[-] create_options.h [edit]
[-] sql_crypt.h [edit]
[-] mem_root_array.h [edit]
[-] item_windowfunc.h [edit]
[-] my_default.h [edit]
[-] event_data_objects.h [edit]
[-] wqueue.h [edit]
[-] wsrep_applier.h [edit]
[-] dur_prop.h [edit]
[-] lex_symbol.h [edit]
[-] wsrep_mysqld_c.h [edit]
[-] sql_get_diagnostics.h [edit]
[-] wsrep_mutex.h [edit]
[-] contributors.h [edit]
[-] queues.h [edit]
[-] event_db_repository.h [edit]
[-] waiting_threads.h [edit]
[-] ft_global.h [edit]
[-] multi_range_read.h [edit]
[-] events.h [edit]
[-] sql_parse.h [edit]
[-] sql_reload.h [edit]
[-] wsrep_condition_variable.h [edit]
[-] item_timefunc.h [edit]
[-] rpl_mi.h [edit]
[-] my_atomic.h [edit]
[-] my_atomic_wrapper.h [edit]
[-] welcome_copyright_notice.h [edit]
[-] sql_digest_stream.h [edit]
[-] parse_file.h [edit]
[-] opt_trace.h [edit]
[-] myisampack.h [edit]
[-] ha_sequence.h [edit]
[-] sql_explain.h [edit]
[-] simple_tokenizer.h [edit]
[-] slave.h [edit]
[-] sql_list.h [edit]
[-] aligned.h [edit]
[-] item_func.h [edit]
[-] opt_subselect.h [edit]
[-] rpl_constants.h [edit]
[-] sql_hset.h [edit]
[-] maria.h [edit]
[-] sql_join_cache.h [edit]
[-] sql_plugin_compat.h [edit]
[-] json_schema_helper.h [edit]
[-] span.h [edit]
[-] gstream.h [edit]
[-] my_bit.h [edit]
[-] sql_show.h [edit]
[-] thr_malloc.h [edit]
[-] vers_string.h [edit]
[-] sql_array.h [edit]
[-] threadpool_generic.h [edit]
[-] sp_cache.h [edit]
[-] records.h [edit]
[-] sql_do.h [edit]
[-] my_stacktrace.h [edit]
[-] opt_range.h [edit]
[-] keycaches.h [edit]
[-] mariadb.h [edit]
[-] deprecation.h [edit]
[-] sql_bootstrap.h [edit]
[-] scheduler.h [edit]
[-] my_libwrap.h [edit]
[-] compat56.h [edit]
[-] grant.h [edit]
[-] item_geofunc.h [edit]
[-] pfs_table_provider.h [edit]
[-] sql_help.h [edit]
[-] sql_derived.h [edit]
[-] hash.h [edit]
[-] rpl_utility.h [edit]
[-] my_stack_alloc.h [edit]
[-] my_apc.h [edit]
[-] sql_base.h [edit]
[-] item_cmpfunc.h [edit]
[-] discover.h [edit]
[-] item.h [edit]
[-] opt_rewrite_date_cmp.h [edit]
[-] json_table.h [edit]
[-] xa.h [edit]
[-] semisync_master_ack_receiver.h [edit]
[-] sql_truncate.h [edit]
[-] winservice.h [edit]
[-] wsrep_types.h [edit]
[-] gtid_index.h [edit]
[-] rpl_tblmap.h [edit]
[-] item_row.h [edit]
[-] sql_limit.h [edit]
[-] rpl_injector.h [edit]
[-] item_vers.h [edit]
[-] event_parse_data.h [edit]
[-] my_user.h [edit]
[-] password.h [edit]
[-] sql_servers.h [edit]
[-] aria_backup.h [edit]
[-] wsrep_binlog.h [edit]
[-] filesort_utils.h [edit]
[-] sql_alloc.h [edit]
[-] des_key_file.h [edit]
[-] sp.h [edit]
[-] derror.h [edit]
[-] heap.h [edit]
[-] ha_handler_stats.h [edit]
[-] sql_load.h [edit]
[-] handle_connections_win.h [edit]
[-] item_strfunc.h [edit]
[-] wsrep_server_state.h [edit]
[-] rpl_gtid.h [edit]
[-] sql_time.h [edit]
[-] log_cache.h [edit]
[-] sql_analyse.h [edit]
[-] wsrep_server_service.h [edit]
[-] strfunc.h [edit]
[-] sql_locale.h [edit]
[-] lex_string.h [edit]
[-] sys_vars_shared.h [edit]
[-] lex_charset.h [edit]
[-] sql_partition.h [edit]
[-] rpl_rli.h [edit]
[-] thr_lock.h [edit]
[-] sql_prepare.h [edit]
[-] select_handler.h [edit]
[-] handler.h [edit]
[-] sql_cursor.h [edit]
[-] probes_mysql.h [edit]
[-] sql_statistics.h [edit]
[-] sql_repl.h [edit]
[-] source_revision.h [edit]
[-] sql_class.h [edit]
[-] opt_histogram_json.h [edit]
[-] derived_handler.h [edit]
[-] sql_type.h [edit]
[-] my_handler_errors.h [edit]
[-] sql_cache.h [edit]
[-] sql_delete.h [edit]
[-] mysqld_default_groups.h [edit]
[-] sql_admin.h [edit]
[-] wsrep_trans_observer.h [edit]
[-] cset_narrowing.h [edit]
[-] log_event.h [edit]
[-] optimizer_costs.h [edit]
[-] item_subselect.h [edit]
[-] my_uctype.h [edit]
[-] ilist.h [edit]
[-] sql_handler.h [edit]
[-] sql_plist.h [edit]
[-] group_by_handler.h [edit]
[-] sql_expression_cache.h [edit]
[-] item_sum.h [edit]
[-] thread_cache.h [edit]
[-] json_schema.h [edit]
[-] sql_alter.h [edit]
[-] lex_ident.h [edit]
[-] wsrep_status.h [edit]
[-] assume_aligned.h [edit]
[-] threadpool.h [edit]
[-] my_time.h [edit]
[-] sql_type_geom.h [edit]
[-] event_queue.h [edit]
[-] repl_failsafe.h [edit]
[-] ssl_compat.h [edit]
[-] sql_type_string.h [edit]
[-] debug.h [edit]
[-] sql_db.h [edit]
[+] data
[-] t_ctype.h [edit]
[-] sql_test.h [edit]
[-] wsrep_schema.h [edit]
[-] wsrep_client_service.h [edit]
[-] sql_binlog.h [edit]
[-] session_tracker.h [edit]
[-] my_cpu.h [edit]
[-] sql_type_timeofday.h [edit]
[-] my_bitmap.h [edit]
[-] sp_rcontext.h [edit]
[-] wsrep_plugin.h [edit]
[-] sql_sequence.h [edit]
[-] sql_trigger.h [edit]
[-] log.h [edit]
[-] semisync_slave.h [edit]
[-] sql_debug.h [edit]
[-] optimizer_defaults.h [edit]
[-] event_scheduler.h [edit]
[-] set_var.h [edit]
[-] pfs_idle_provider.h [edit]
[-] mysqld.h [edit]
[-] sql_used.h [edit]
[-] sql_callback.h [edit]
[-] gcalc_slicescan.h [edit]
[-] tzfile.h [edit]
[-] sql_union.h [edit]
[-] wsrep_sst.h [edit]
[-] gcalc_tools.h [edit]
[-] opt_trace_context.h [edit]
[-] semisync.h [edit]
[-] pfs_transaction_provider.h [edit]
[-] sql_acl.h [edit]
[-] create_tmp_table.h [edit]
[-] rowid_filter.h [edit]
[-] my_decimal.h [edit]
[-] char_buffer.h [edit]
[-] custom_conf.h [edit]
[-] mysqld_suffix.h [edit]
[-] message.h [edit]
[-] init.h [edit]
[-] structs.h [edit]
[-] replication.h [edit]
[-] semisync_master.h [edit]
[-] sql_update.h [edit]
[-] my_minidump.h [edit]
[-] sql_mode.h [edit]
[-] sql_signal.h [edit]
[-] wsrep_client_state.h [edit]
[-] innodb_priv.h [edit]
[-] lock.h [edit]
[-] bounded_queue.h [edit]
[-] log_event_data_type.h [edit]
[-] socketpair.h [edit]
[-] sql_cte.h [edit]
[-] table_cache.h [edit]
[-] partition_element.h [edit]
[-] violite.h [edit]
[-] sql_cmd.h [edit]
[-] my_tree.h [edit]
[-] pfs_statement_provider.h [edit]
[-] wsrep_allowlist_service.h [edit]
[-] pfs_metadata_provider.h [edit]
[-] item_create.h [edit]
[-] my_crypt.h [edit]
[-] sql_sort.h [edit]
[-] my_counter.h [edit]
[-] myisam.h [edit]
[-] sql_priv.h [edit]
[-] sql_window.h [edit]
[-] my_check_opt.h [edit]
[-] sql_lex.h [edit]
[-] client_settings.h [edit]
[-] table.h [edit]
[-] my_base.h [edit]
[-] partition_info.h [edit]