[tripe] / server / tripe.c

/* -*-c-*-
 *
 * Main program
 *
 * (c) 2001 Straylight/Edgeware
 */

/*----- Licensing notice --------------------------------------------------*
 *
 * This file is part of Trivial IP Encryption (TrIPE).
 *
 * TrIPE 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.
 *
 * TrIPE 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 TrIPE.  If not, see <https://www.gnu.org/licenses/>.
 */

/*----- Header files ------------------------------------------------------*/

#include "tripe.h"

/*----- Global variables --------------------------------------------------*/

sel_state sel;

/*----- Static variables --------------------------------------------------*/

static sel_timer it;
#define T_INTERVAL MIN(1)

/*----- Main code ---------------------------------------------------------*/

/* --- @interval@ --- *
 *
 * Arguments:	@struct timeval *tv@ = time when called
 *		@void *v@ = boring pointer
 *
 * Returns:	---
 *
 * Use:		Called periodically to do housekeeping tasks.
 */

static void interval(struct timeval *tv, void *v)
{
  struct timeval tvv;
  T( trace(T_PEER, "peer: interval timer"); )
  rand_seed(RAND_GLOBAL, MAXHASHSZ);
  p_interval();
  tvv = *tv;
  tvv.tv_sec += T_INTERVAL;
  sel_addtimer(&sel, &it, &tvv, interval, v);
}

/* --- @main@ --- *
 *
 * Arguments:	@int argc@ = number of command line arguments
 *		@char *argv[]@ = vector of arguments
 *
 * Returns:	Zero if OK, nonzero on error.
 *
 * Use:		Main program.  Provides a simple VPN.
 */

static void usage(FILE *fp)
{
  pquis(fp, "Usage: $ [-DF] [-d DIR] [-b ADDR] [-p PORT] [-n TUNNEL]\n\
	[-U USER] [-G GROUP] [-a SOCKET] [-m MODE] [-T TRACE-OPTS]\n\
	[-k PRIV-KEYRING] [-K PUB-KEYRING] [-t KEY-TAG]\n");
}

static void version(FILE *fp) { pquis(fp, "$, version " VERSION "\n"); }

static void help(FILE *fp)
{
  version(fp);
  fputc('\n', fp);
  usage(fp);
  fputs("\n\
Options:\n\
\n\
-h, --help		Display this help text.\n\
-v, --version		Display version number.\n\
-u, --usage		Display pointless usage message.\n\
    --tunnels		Display IP tunnel drivers and exit.\n\
\n\
-D, --daemon		Run in the background.\n\
-F, --foreground	Quit when stdin reports end-of-file.\n\
-d, --directory=DIR	Switch to directory DIR [default " CONFIGDIR "].\n\
-b, --bind-address=ADDR	Bind UDP socket to this IP ADDR.\n\
-p, --port=PORT		Select UDP port to listen to "
	"[default " STR(TRIPE_PORT) "].\n\
-n, --tunnel=TUNNEL	Seelect default tunnel driver.\n\
-U, --setuid=USER	Set uid to USER after initialization.\n\
-G, --setgid=GROUP	Set gid to GROUP after initialization.\n\
-k, --priv-keyring=FILE	Get private key from FILE.\n\
-K, --pub-keyring=FILE	Get public keys from FILE.\n\
-t, --tag=KEYTAG	Use private key labelled TAG.\n\
-a, --admin-socket=FILE	Use FILE as the adminstration socket.\n\
-m, --admin-perms=MODE	Permissions to set on admin socket [default 600].\n\
" T( "\
-T, --trace=OPTIONS	Turn on tracing options.\n\
" ) "\
", fp);
}

int main(int argc, char *argv[])
{
  const char *kr_priv = "keyring", *kr_pub = "keyring.pub";
  const char *tag_priv = 0;
  const char *csock = SOCKETDIR "/tripesock";
  int csockmode = 0600;
  const char *dir = CONFIGDIR;
  const char *p;
  const char *bindhost = 0, *bindsvc = STR(TRIPE_PORT);
  struct addrinfo aihint = { 0 }, *ailist;
  unsigned f = 0;
  int i;
  int err, selerr = 0;
  unsigned af;
  struct timeval tv;
  uid_t u = -1;
  gid_t g = -1;

#define f_bogus 1u
#define f_daemon 2u
#define f_foreground 4u

  ego(argv[0]);
  T( trace_on(stderr, 0); )

  if ((p = getenv("TRIPEDIR")) != 0)
    dir = p;
  if ((p = getenv("TRIPESOCK")) != 0)
    csock = p;
  tun_default = tunnels[0];
  aihint.ai_family = AF_INET;

  for (;;) {
    static const struct option opts[] = {
      { "help",		0,		0,	'h' },
      { "version",	0,		0,	'v' },
      { "usage",	0,		0,	'u' },
      { "tunnels",	0,		0,	'0' },

      { "daemon",	0,		0,	'D' },
      { "foreground",	0,		0,	'F' },
      { "uid",		OPTF_ARGREQ,	0,	'U' },
      { "setuid",	OPTF_ARGREQ,	0,	'U' },
      { "gid",		OPTF_ARGREQ,	0,	'G' },
      { "setgid",	OPTF_ARGREQ,	0,	'G' },
      { "bind-address",	OPTF_ARGREQ,	0,	'b' },
      { "tunnel",	OPTF_ARGREQ,	0,	'n' },
      { "port",		OPTF_ARGREQ,	0,	'p' },
      { "directory",	OPTF_ARGREQ,	0,	'd' },
      { "priv-keyring",	OPTF_ARGREQ,	0,	'k' },
      { "pub-keyring",	OPTF_ARGREQ,	0,	'K' },
      { "tag",		OPTF_ARGREQ,	0,	't' },
      { "admin-socket", OPTF_ARGREQ,	0,	'a' },
      { "admin-perms",	OPTF_ARGREQ,	0,	'm' },
#ifndef NTRACE
      { "trace",	OPTF_ARGREQ,	0,	'T' },
#endif

      { 0,		0,		0,	0 }
    };

    i = mdwopt(argc, argv, "hvuDFU:G:b:n:p:d:k:K:t:a:m:" T("T:"),
	       opts, 0, 0, 0);
    if (i < 0)
      break;
    switch (i) {
      case 'h':
	help(stdout);
	exit(0);
      case 'v':
	version(stdout);
	exit(0);
      case 'u':
	usage(stdout);
	exit(0);

      case 'D':
	f |= f_daemon;
	break;
      case 'U':
	u = u_getuser(optarg, &g);
	break;
      case 'G':
	g = u_getgroup(optarg);
	break;
      case 'F':
	f |= f_foreground;
	break;

      case 'b':
	bindhost = optarg;
	break;
      case 'p':
	bindsvc = optarg;
	break;
      case 'n': {
	int i;
	for (i = 0;; i++) {
	  if (!tunnels[i])
	    die(EXIT_FAILURE, "unknown tunnel `%s'", optarg);
	  if (mystrieq(optarg, tunnels[i]->name))
	    break;
	}
	tun_default = tunnels[i];
      } break;
      case 'd':
	dir = optarg;
	break;
      case 'k':
	kr_priv = optarg;
	break;
      case 'K':
	kr_pub = optarg;
	break;
      case 'a':
	csock = optarg;
	break;
      case 'm': {
	char *p;
	csockmode = strtol(optarg, &p, 8);
	if (*p) die(EXIT_FAILURE, "bad permissions: `%s'", optarg);
      } break;
      case 't':
	tag_priv = optarg;
	break;
#ifndef NTRACE
      case 'T':
	tr_flags = traceopt(tr_opts, optarg, tr_flags, 0);
	trace_level(tr_flags);
	break;
#endif
      case '0': {
	int i;
	for (i = 0; tunnels[i]; i++)
	  puts(tunnels[i]->name);
	exit(0);
      } break;
      default:
	f |= f_bogus;
	break;
    }
  }

  if (optind < argc || (f & f_bogus)) {
    usage(stderr);
    exit(EXIT_FAILURE);
  }
  if (!(~f & (f_daemon | f_foreground)))
    die(EXIT_FAILURE, "foreground operation for a daemon is silly");

  aihint.ai_protocol = IPPROTO_UDP;
  aihint.ai_socktype = SOCK_DGRAM;
  aihint.ai_flags = AI_PASSIVE | AI_ADDRCONFIG;
  if ((err = getaddrinfo(bindhost, bindsvc, &aihint, &ailist)) != 0) {
    die(EXIT_FAILURE, "couldn't resolve hostname %c%s%c, port `%s': %s",
	bindhost ? '`' : '<',
	bindhost ? bindhost : "nil",
	bindhost ? '\'' : '>',
	bindsvc, gai_strerror(err));
  }

  if (chdir(dir)) {
    die(EXIT_FAILURE, "can't set current directory to `%s': %s",
	dir, strerror(errno));
  }

  sel_init(&sel);
  sig_init(&sel);
  rand_noisesrc(RAND_GLOBAL, &noise_source);
  rand_seed(RAND_GLOBAL, MAXHASHSZ);
  signal(SIGPIPE, SIG_IGN);
  for (i = 0; tunnels[i]; i++)
    tunnels[i]->init();
  p_init(ailist); freeaddrinfo(ailist);
  if (!(f & f_daemon)) {
    af = AF_WARN;
#ifndef NTRACE
    af |= AF_TRACE;
#endif
    if (f & f_foreground)
      af |= AF_FOREGROUND;
    a_create(STDIN_FILENO, STDOUT_FILENO, af);
  }
  ps_split(f & f_daemon);
  a_init(csock, u, g, csockmode);
  u_setugid(u, g);
  km_init(kr_priv, kr_pub, tag_priv);
  if (f & f_daemon) {
    if (daemonize())
      die(EXIT_FAILURE, "couldn't become a daemon: %s", strerror(errno));
    a_daemon();
  }

  tv.tv_sec = time(0) + T_INTERVAL;
  tv.tv_usec = 0;
  sel_addtimer(&sel, &it, &tv, interval, 0);

  for (;;) {
    a_preselect();
    if (!sel_select(&sel))
      selerr = 0;
    else if (errno != EINTR && errno != EAGAIN) {
      a_warn("SERVER", "select-error", "?ERRNO", A_END);
      selerr++;
      if (selerr > 8) {
	a_warn("ABORT", "repeated-select-errors", A_END);
	abort();
      }
    }
  }

  return (0);
}

/*----- That's all, folks -------------------------------------------------*/
Commit	Line	Data
410c8acf	1	/* --c--
410c8acf	2	*
	3	* Main program
	4	*
	5	* (c) 2001 Straylight/Edgeware
	6	*/
	7
e04c2d50	8	/----- Licensing notice --------------------------------------------------
410c8acf	9	*
	10	* This file is part of Trivial IP Encryption (TrIPE).
	11	*
11ad66c2 MW	12	* TrIPE is free software: you can redistribute it and/or modify it under
	13	* the terms of the GNU General Public License as published by the Free
	14	* Software Foundation; either version 3 of the License, or (at your
	15	* option) any later version.
e04c2d50	16	*
11ad66c2 MW	17	* TrIPE is distributed in the hope that it will be useful, but WITHOUT
	18	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	19	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
	20	* for more details.
e04c2d50	21	*
410c8acf	22	* You should have received a copy of the GNU General Public License
11ad66c2	23	* along with TrIPE. If not, see <https://www.gnu.org/licenses/>.
410c8acf	24	*/
410c8acf	25
410c8acf	26	/----- Header files ------------------------------------------------------/
	27
	28	#include "tripe.h"
	29
	30	/----- Global variables --------------------------------------------------/
	31
	32	sel_state sel;
410c8acf	33
	34	/----- Static variables --------------------------------------------------/
	35
	36	static sel_timer it;
	37	#define T_INTERVAL MIN(1)
	38
	39	/----- Main code ---------------------------------------------------------/
	40
	41	/* --- @interval@ --- *
	42	*
	43	* Arguments: @struct timeval *tv@ = time when called
	44	* @void *v@ = boring pointer
	45	*
	46	* Returns: ---
	47	*
	48	* Use: Called periodically to do housekeeping tasks.
	49	*/
	50
42da2a58	51	static void interval(struct timeval tv, void v)
410c8acf	52	{
	53	struct timeval tvv;
	54	T( trace(T_PEER, "peer: interval timer"); )
b5c45da1	55	rand_seed(RAND_GLOBAL, MAXHASHSZ);
410c8acf	56	p_interval();
	57	tvv = *tv;
	58	tvv.tv_sec += T_INTERVAL;
	59	sel_addtimer(&sel, &it, &tvv, interval, v);
	60	}
	61
	62	/* --- @main@ --- *
	63	*
	64	* Arguments: @int argc@ = number of command line arguments
	65	* @char *argv[]@ = vector of arguments
	66	*
	67	* Returns: Zero if OK, nonzero on error.
	68	*
	69	* Use: Main program. Provides a simple VPN.
	70	*/
	71
	72	static void usage(FILE *fp)
	73	{
46dde080	74	pquis(fp, "Usage: $ [-DF] [-d DIR] [-b ADDR] [-p PORT] [-n TUNNEL]\n\
a9279e37	75	[-U USER] [-G GROUP] [-a SOCKET] [-m MODE] [-T TRACE-OPTS]\n\
2d752320	76	[-k PRIV-KEYRING] [-K PUB-KEYRING] [-t KEY-TAG]\n");
410c8acf	77	}
410c8acf	78
f98df549	79	static void version(FILE *fp) { pquis(fp, "$, version " VERSION "\n"); }
410c8acf	80
	81	static void help(FILE *fp)
	82	{
	83	version(fp);
	84	fputc('\n', fp);
	85	usage(fp);
	86	fputs("\n\
	87	Options:\n\
	88	\n\
	89	-h, --help Display this help text.\n\
	90	-v, --version Display version number.\n\
	91	-u, --usage Display pointless usage message.\n\
42da2a58	92	--tunnels Display IP tunnel drivers and exit.\n\
410c8acf	93	\n\
410c8acf	94	-D, --daemon Run in the background.\n\
46dde080	95	-F, --foreground Quit when stdin reports end-of-file.\n\
ef4a1ab7	96	-d, --directory=DIR Switch to directory DIR [default " CONFIGDIR "].\n\
d13e5724	97	-b, --bind-address=ADDR Bind UDP socket to this IP ADDR.\n\
165efde7 MW	98	-p, --port=PORT Select UDP port to listen to "
165efde7 MW	99	"[default " STR(TRIPE_PORT) "].\n\
42da2a58	100	-n, --tunnel=TUNNEL Seelect default tunnel driver.\n\
d13e5724	101	-U, --setuid=USER Set uid to USER after initialization.\n\
d13e5724	102	-G, --setgid=GROUP Set gid to GROUP after initialization.\n\
410c8acf	103	-k, --priv-keyring=FILE Get private key from FILE.\n\
	104	-K, --pub-keyring=FILE Get public keys from FILE.\n\
	105	-t, --tag=KEYTAG Use private key labelled TAG.\n\
	106	-a, --admin-socket=FILE Use FILE as the adminstration socket.\n\
a9279e37	107	-m, --admin-perms=MODE Permissions to set on admin socket [default 600].\n\
c5a2ea9b	108	" T( "\
410c8acf	109	-T, --trace=OPTIONS Turn on tracing options.\n\
c5a2ea9b	110	" ) "\
410c8acf	111	", fp);
	112	}
	113
	114	int main(int argc, char *argv[])
	115	{
	116	const char kr_priv = "keyring", kr_pub = "keyring.pub";
fc5f4823	117	const char *tag_priv = 0;
ef4a1ab7	118	const char *csock = SOCKETDIR "/tripesock";
a9279e37	119	int csockmode = 0600;
ef4a1ab7	120	const char *dir = CONFIGDIR;
410c8acf	121	const char *p;
89640f3f MW	122	const char bindhost = 0, bindsvc = STR(TRIPE_PORT);
89640f3f MW	123	struct addrinfo aihint = { 0 }, *ailist;
410c8acf	124	unsigned f = 0;
42da2a58	125	int i;
89640f3f	126	int err, selerr = 0;
46dde080	127	unsigned af;
42da2a58	128	struct timeval tv;
410c8acf	129	uid_t u = -1;
	130	gid_t g = -1;
	131
	132	#define f_bogus 1u
	133	#define f_daemon 2u
46dde080	134	#define f_foreground 4u
410c8acf	135
410c8acf	136	ego(argv[0]);
d360f042	137	T( trace_on(stderr, 0); )
410c8acf	138
	139	if ((p = getenv("TRIPEDIR")) != 0)
	140	dir = p;
797cf76b MW	141	if ((p = getenv("TRIPESOCK")) != 0)
797cf76b MW	142	csock = p;
42da2a58	143	tun_default = tunnels[0];
89640f3f	144	aihint.ai_family = AF_INET;
410c8acf	145
	146	for (;;) {
	147	static const struct option opts[] = {
	148	{ "help", 0, 0, 'h' },
	149	{ "version", 0, 0, 'v' },
	150	{ "usage", 0, 0, 'u' },
42da2a58	151	{ "tunnels", 0, 0, '0' },
410c8acf	152
410c8acf	153	{ "daemon", 0, 0, 'D' },
46dde080	154	{ "foreground", 0, 0, 'F' },
410c8acf	155	{ "uid", OPTF_ARGREQ, 0, 'U' },
	156	{ "setuid", OPTF_ARGREQ, 0, 'U' },
	157	{ "gid", OPTF_ARGREQ, 0, 'G' },
	158	{ "setgid", OPTF_ARGREQ, 0, 'G' },
767b36e2	159	{ "bind-address", OPTF_ARGREQ, 0, 'b' },
42da2a58	160	{ "tunnel", OPTF_ARGREQ, 0, 'n' },
410c8acf	161	{ "port", OPTF_ARGREQ, 0, 'p' },
	162	{ "directory", OPTF_ARGREQ, 0, 'd' },
	163	{ "priv-keyring", OPTF_ARGREQ, 0, 'k' },
	164	{ "pub-keyring", OPTF_ARGREQ, 0, 'K' },
	165	{ "tag", OPTF_ARGREQ, 0, 't' },
	166	{ "admin-socket", OPTF_ARGREQ, 0, 'a' },
a9279e37	167	{ "admin-perms", OPTF_ARGREQ, 0, 'm' },
410c8acf	168	#ifndef NTRACE
	169	{ "trace", OPTF_ARGREQ, 0, 'T' },
	170	#endif
	171
	172	{ 0, 0, 0, 0 }
	173	};
	174
a9279e37	175	i = mdwopt(argc, argv, "hvuDFU:G:b:n:p:d:k:K:t:a:m:" T("T:"),
42da2a58	176	opts, 0, 0, 0);
410c8acf	177	if (i < 0)
	178	break;
	179	switch (i) {
	180	case 'h':
	181	help(stdout);
	182	exit(0);
	183	case 'v':
	184	version(stdout);
	185	exit(0);
	186	case 'u':
	187	usage(stdout);
	188	exit(0);
	189
	190	case 'D':
	191	f \|= f_daemon;
	192	break;
52b86648 MW	193	case 'U':
	194	u = u_getuser(optarg, &g);
	195	break;
	196	case 'G':
	197	g = u_getgroup(optarg);
	198	break;
46dde080 MW	199	case 'F':
	200	f \|= f_foreground;
	201	break;
767b36e2	202
89640f3f MW	203	case 'b':
	204	bindhost = optarg;
	205	break;
	206	case 'p':
	207	bindsvc = optarg;
	208	break;
42da2a58	209	case 'n': {
	210	int i;
	211	for (i = 0;; i++) {
	212	if (!tunnels[i])
	213	die(EXIT_FAILURE, "unknown tunnel `%s'", optarg);
	214	if (mystrieq(optarg, tunnels[i]->name))
	215	break;
	216	}
	217	tun_default = tunnels[i];
	218	} break;
410c8acf	219	case 'd':
	220	dir = optarg;
	221	break;
	222	case 'k':
	223	kr_priv = optarg;
	224	break;
	225	case 'K':
	226	kr_pub = optarg;
	227	break;
	228	case 'a':
	229	csock = optarg;
	230	break;
a9279e37 MW	231	case 'm': {
	232	char *p;
	233	csockmode = strtol(optarg, &p, 8);
	234	if (*p) die(EXIT_FAILURE, "bad permissions: `%s'", optarg);
	235	} break;
410c8acf	236	case 't':
	237	tag_priv = optarg;
	238	break;
	239	#ifndef NTRACE
	240	case 'T':
	241	tr_flags = traceopt(tr_opts, optarg, tr_flags, 0);
	242	trace_level(tr_flags);
	243	break;
	244	#endif
ef4a1ab7	245	case '0': {
42da2a58	246	int i;
	247	for (i = 0; tunnels[i]; i++)
	248	puts(tunnels[i]->name);
ef4a1ab7	249	exit(0);
ef4a1ab7	250	} break;
410c8acf	251	default:
	252	f \|= f_bogus;
	253	break;
	254	}
	255	}
	256
	257	if (optind < argc \|\| (f & f_bogus)) {
	258	usage(stderr);
	259	exit(EXIT_FAILURE);
	260	}
46dde080 MW	261	if (!(~f & (f_daemon \| f_foreground)))
46dde080 MW	262	die(EXIT_FAILURE, "foreground operation for a daemon is silly");
410c8acf	263
89640f3f MW	264	aihint.ai_protocol = IPPROTO_UDP;
	265	aihint.ai_socktype = SOCK_DGRAM;
	266	aihint.ai_flags = AI_PASSIVE \| AI_ADDRCONFIG;
	267	if ((err = getaddrinfo(bindhost, bindsvc, &aihint, &ailist)) != 0) {
	268	die(EXIT_FAILURE, "couldn't resolve hostname %c%s%c, port `%s': %s",
	269	bindhost ? '`' : '<',
	270	bindhost ? bindhost : "nil",
	271	bindhost ? '\'' : '>',
	272	bindsvc, gai_strerror(err));
	273	}
	274
410c8acf	275	if (chdir(dir)) {
	276	die(EXIT_FAILURE, "can't set current directory to `%s': %s",
	277	dir, strerror(errno));
	278	}
	279
	280	sel_init(&sel);
	281	sig_init(&sel);
	282	rand_noisesrc(RAND_GLOBAL, &noise_source);
b5c45da1	283	rand_seed(RAND_GLOBAL, MAXHASHSZ);
410c8acf	284	signal(SIGPIPE, SIG_IGN);
42da2a58	285	for (i = 0; tunnels[i]; i++)
42da2a58	286	tunnels[i]->init();
89640f3f	287	p_init(ailist); freeaddrinfo(ailist);
3cdc3f3a	288	if (!(f & f_daemon)) {
46dde080	289	af = AF_WARN;
3cdc3f3a	290	#ifndef NTRACE
46dde080	291	af \|= AF_TRACE;
3cdc3f3a	292	#endif
46dde080 MW	293	if (f & f_foreground)
	294	af \|= AF_FOREGROUND;
	295	a_create(STDIN_FILENO, STDOUT_FILENO, af);
3cdc3f3a	296	}
388e0319	297	ps_split(f & f_daemon);
a9279e37	298	a_init(csock, u, g, csockmode);
52b86648	299	u_setugid(u, g);
410c8acf	300	km_init(kr_priv, kr_pub, tag_priv);
410c8acf	301	if (f & f_daemon) {
19dd2531	302	if (daemonize())
410c8acf	303	die(EXIT_FAILURE, "couldn't become a daemon: %s", strerror(errno));
	304	a_daemon();
	305	}
	306
42da2a58	307	tv.tv_sec = time(0) + T_INTERVAL;
	308	tv.tv_usec = 0;
	309	sel_addtimer(&sel, &it, &tv, interval, 0);
410c8acf	310
42da2a58	311	for (;;) {
c511e1f9	312	a_preselect();
42da2a58	313	if (!sel_select(&sel))
	314	selerr = 0;
	315	else if (errno != EINTR && errno != EAGAIN) {
f43df819	316	a_warn("SERVER", "select-error", "?ERRNO", A_END);
42da2a58	317	selerr++;
42da2a58	318	if (selerr > 8) {
f43df819	319	a_warn("ABORT", "repeated-select-errors", A_END);
42da2a58	320	abort();
410c8acf	321	}
	322	}
	323	}
	324
	325	return (0);
	326	}
	327
	328	/----- That's all, folks -------------------------------------------------/