daead879faa7f4dff4d9016c68f95426269551f0
[paraslash.git] / client_common.c
1 /*
2  * Copyright (C) 1997-2012 Andre Noll <maan@systemlinux.org>
3  *
4  * Licensed under the GPL v2. For licencing details see COPYING.
5  */
6
7 /** \file client_common.c Common functions of para_client and para_audiod. */
8
9 #include <regex.h>
10 #include <sys/types.h>
11
12 #include "para.h"
13 #include "error.h"
14 #include "list.h"
15 #include "sched.h"
16 #include "client.cmdline.h"
17 #include "crypt.h"
18 #include "net.h"
19 #include "fd.h"
20 #include "sideband.h"
21 #include "string.h"
22 #include "client.cmdline.h"
23 #include "client.h"
24 #include "buffer_tree.h"
25 #include "version.h"
26
27 /** The size of the receiving buffer. */
28 #define CLIENT_BUFSIZE 4000
29
30 /**
31  * Close the connection to para_server and deallocate per-command ressources.
32  *
33  * \param ct The client task.
34  *
35  * This frees all ressources of the current command but keeps the configuration
36  * in \p ct->conf.
37  *
38  * \sa \ref client_close().
39  */
40 void client_disconnect(struct client_task *ct)
41 {
42         if (!ct)
43                 return;
44         if (ct->scc.fd >= 0)
45                 close(ct->scc.fd);
46         free_argv(ct->features);
47         sc_free(ct->scc.recv);
48         ct->scc.recv = NULL;
49         sc_free(ct->scc.send);
50         ct->scc.send = NULL;
51         btr_free_node(ct->btrn);
52         ct->btrn = NULL;
53 }
54
55 /**
56  * Close the connection to para_server and free all resources.
57  *
58  * \param ct Pointer to the client data.
59  *
60  * \sa \ref client_open(), \ref client_disconnect().
61  */
62 void client_close(struct client_task *ct)
63 {
64         if (!ct)
65                 return;
66         client_disconnect(ct);
67         free(ct->user);
68         free(ct->config_file);
69         free(ct->key_file);
70         client_cmdline_parser_free(&ct->conf);
71         free(ct->challenge_hash);
72         sb_free(ct->sbc);
73         free(ct);
74 }
75
76 /**
77  * The preselect hook for server commands.
78  *
79  * \param s Pointer to the scheduler.
80  * \param t Pointer to the task struct for this command.
81  *
82  * The task pointer must contain a pointer to the initialized client data
83  * structure as it is returned by client_open().
84  *
85  * This function checks the state of the connection and adds the file descriptor
86  * of the connection to the read or write fd set of \a s accordingly.
87  *
88  * \sa register_task() client_open(), struct sched, struct task.
89  */
90 static void client_pre_select(struct sched *s, struct task *t)
91 {
92         int ret;
93         struct client_task *ct = container_of(t, struct client_task, task);
94         struct btr_node *btrn = ct->btrn;
95
96         if (ct->scc.fd < 0)
97                 return;
98         switch (ct->status) {
99         case CL_CONNECTED:
100         case CL_SENT_AUTH:
101         case CL_SENT_CH_RESPONSE:
102         case CL_SENT_COMMAND:
103                 para_fd_set(ct->scc.fd, &s->rfds, &s->max_fileno);
104                 return;
105
106         case CL_RECEIVED_WELCOME:
107         case CL_RECEIVED_PROCEED:
108         case CL_RECEIVED_CHALLENGE:
109                 para_fd_set(ct->scc.fd, &s->wfds, &s->max_fileno);
110                 return;
111
112         case CL_RECEIVING:
113                 ret = btr_node_status(btrn, 0, BTR_NT_ROOT);
114                 if (ret != 0) {
115                         if (ret < 0)
116                                 sched_min_delay(s);
117                         else
118                                 para_fd_set(ct->scc.fd, &s->rfds,
119                                         &s->max_fileno);
120                 }
121                 return;
122         case CL_SENDING:
123                 ret = btr_node_status(btrn, 0, BTR_NT_LEAF);
124                 if (ret != 0) {
125                         if (ret < 0)
126                                 sched_min_delay(s);
127                         else
128                                 para_fd_set(ct->scc.fd, &s->wfds,
129                                         &s->max_fileno);
130                 }
131                 return;
132         }
133 }
134
135 static int client_recv_buffer(struct client_task *ct, fd_set *rfds,
136                 char *buf, size_t sz, size_t *n)
137 {
138         int ret;
139
140         if (ct->status < CL_SENT_CH_RESPONSE)
141                 return read_nonblock(ct->scc.fd, buf, sz, rfds, n);
142
143         *n = 0;
144         ret = sc_recv_buffer(&ct->scc, buf, sz);
145         /*
146          * sc_recv_buffer is used with blocking fds elsewhere, so it
147          * does not use the nonblock-API. Therefore we need to
148          * check for EOF and EAGAIN.
149          */
150         if (ret == 0)
151                 return -E_SERVER_EOF;
152         if (ret == -ERRNO_TO_PARA_ERROR(EAGAIN))
153                 return 0;
154         if (ret < 0)
155                 return ret;
156         *n = ret;
157         return 0;
158 }
159
160 static int send_sb(struct client_task *ct, void *buf, size_t numbytes,
161                 enum sb_designator band, bool dont_free)
162 {
163         int ret, fd = ct->scc.fd;
164         struct iovec iov[2];
165
166         if (!ct->sbc) {
167                 struct sb_buffer sbb;
168                 sb_transformation trafo = ct->status < CL_RECEIVED_PROCEED?
169                         NULL : sc_trafo;
170                 sbb = (typeof(sbb))SBB_INIT(band, buf, numbytes);
171                 ct->sbc = sb_new_send(&sbb, dont_free, trafo, ct->scc.send);
172         }
173         ret = sb_get_send_buffers(ct->sbc, iov);
174         ret = xwritev(fd, iov, ret);
175         if (ret < 0) {
176                 sb_free(ct->sbc);
177                 ct->sbc = NULL;
178                 return ret;
179         }
180         if (sb_sent(ct->sbc, ret)) {
181                 ct->sbc = NULL;
182                 return 1;
183         }
184         return 0;
185 }
186
187 static int recv_sb(struct client_task *ct, fd_set *rfds,
188                 struct sb_buffer *result)
189 {
190         int ret;
191         size_t n;
192         sb_transformation trafo;
193         void *trafo_context;
194         struct iovec iov;
195
196         if (!FD_ISSET(ct->scc.fd, rfds))
197                 return 0;
198         if (ct->status < CL_SENT_CH_RESPONSE)
199                 trafo = trafo_context = NULL;
200         else {
201                 trafo = sc_trafo;
202                 trafo_context = ct->scc.recv;
203         }
204         if (!ct->sbc)
205                 ct->sbc = sb_new_recv(0, trafo, trafo_context);
206 again:
207         sb_get_recv_buffer(ct->sbc, &iov);
208         ret = read_nonblock(ct->scc.fd, iov.iov_base, iov.iov_len, rfds, &n);
209         if (ret < 0) {
210                 sb_free(ct->sbc);
211                 ct->sbc = NULL;
212                 return ret;
213         }
214         if (n == 0)
215                 return 0;
216         if (!sb_received(ct->sbc, n, result))
217                 goto again;
218         ct->sbc = NULL;
219         return 1;
220 }
221
222
223 static char **parse_features(char *buf)
224 {
225         int i;
226         const char id[] = "\nFeatures: ";
227         char *p, *q, **features;
228
229         p = strstr(buf, id);
230         if (!p)
231                 return NULL;
232         p += strlen(id);
233         q = strchr(p, '\n');
234         if (!q)
235                 return NULL;
236         *q = '\0';
237         create_argv(p, ",", &features);
238         for (i = 0; features[i]; i++)
239                 PARA_INFO_LOG("server feature: %s\n", features[i]);
240         return features;
241 }
242
243 static int dispatch_sbb(struct client_task *ct, struct sb_buffer *sbb)
244 {
245         int ret, ll;
246
247         if (!sbb || !sbb->iov.iov_base || sbb->iov.iov_len == 0)
248                 return 0;
249
250         switch (sbb->band) {
251         case SBD_OUTPUT:
252                 btr_add_output(sbb->iov.iov_base, sbb->iov.iov_len, ct->btrn);
253                 ret = 1;
254                 goto out;
255         case SBD_DEBUG_LOG:
256         case SBD_INFO_LOG:
257         case SBD_NOTICE_LOG:
258         case SBD_WARNING_LOG:
259         case SBD_ERROR_LOG:
260         case SBD_CRIT_LOG:
261         case SBD_EMERG_LOG:
262                 ll = sbb->band - SBD_DEBUG_LOG;
263                 para_log(ll, "remote: %s", (char *)sbb->iov.iov_base);
264                 ret = 1;
265                 goto deallocate;
266         default:
267                 PARA_ERROR_LOG("invalid band %d\n", sbb->band);
268                 ret = -E_BAD_BAND;
269                 goto deallocate;
270         }
271 deallocate:
272         free(sbb->iov.iov_base);
273 out:
274         sbb->iov.iov_base = NULL;
275         return ret;
276 }
277
278 static bool has_feature(const char *feature, struct client_task *ct)
279 {
280         return find_arg(feature, ct->features) >= 0? true : false;
281 }
282
283 static int send_sb_command(struct client_task *ct)
284 {
285         int i;
286         char *command, *p;
287         size_t len = 0;
288
289         if (ct->sbc)
290                 return send_sb(ct, NULL, 0, 0, false);
291
292         for (i = 0; i < ct->conf.inputs_num; i++)
293                 len += strlen(ct->conf.inputs[i]) + 1;
294         p = command = para_malloc(len);
295         for (i = 0; i < ct->conf.inputs_num; i++) {
296                 strcpy(p, ct->conf.inputs[i]);
297                 p += strlen(ct->conf.inputs[i]) + 1;
298         }
299         PARA_DEBUG_LOG("--> %s\n", command);
300         return send_sb(ct, command, len, SBD_COMMAND, false);
301 }
302
303 /**
304  * The post select hook for client commands.
305  *
306  * \param s Pointer to the scheduler.
307  * \param t Pointer to the task struct for this command.
308  *
309  * Depending on the current state of the connection and the status of the read
310  * and write fd sets of \a s, this function performs the necessary steps to
311  * authenticate the connection, to send the command given by \a t->private_data
312  * and to receive para_server's output, if any.
313  *
314  * \sa struct sched, struct task.
315  */
316 static void client_post_select(struct sched *s, struct task *t)
317 {
318         struct client_task *ct = container_of(t, struct client_task, task);
319         struct btr_node *btrn = ct->btrn;
320         int ret = 0;
321         size_t n;
322         char buf[CLIENT_BUFSIZE];
323
324         t->error = 0;
325         if (ct->scc.fd < 0)
326                 return;
327         switch (ct->status) {
328         case CL_CONNECTED: /* receive welcome message */
329                 ret = client_recv_buffer(ct, &s->rfds, buf, sizeof(buf), &n);
330                 if (ret < 0 || n == 0)
331                         goto out;
332                 ct->features = parse_features(buf);
333                 ct->status = CL_RECEIVED_WELCOME;
334                 return;
335         case CL_RECEIVED_WELCOME: /* send auth command */
336                 if (!FD_ISSET(ct->scc.fd, &s->wfds))
337                         return;
338                 if (has_feature("sideband", ct)) {
339                         ct->use_sideband = true;
340                         sprintf(buf, AUTH_REQUEST_MSG "%s sideband", ct->user);
341                 } else
342                         sprintf(buf, AUTH_REQUEST_MSG "%s", ct->user);
343                 PARA_INFO_LOG("--> %s\n", buf);
344                 ret = write_buffer(ct->scc.fd, buf);
345                 if (ret < 0)
346                         goto out;
347                 ct->status = CL_SENT_AUTH;
348                 return;
349         case CL_SENT_AUTH:
350                 /*
351                  * Receive challenge and session keys, decrypt the challenge and
352                  * send back the hash of the decrypted challenge.
353                  */
354                 {
355                 /* decrypted challenge/session key buffer */
356                 unsigned char crypt_buf[1024];
357                 /* the SHA1 of the decrypted challenge */
358
359                 if (ct->use_sideband) {
360                         struct sb_buffer sbb;
361                         ret = recv_sb(ct, &s->rfds, &sbb);
362                         if (ret <= 0)
363                                 goto out;
364                         if (sbb.band != SBD_CHALLENGE) {
365                                 ret = -E_BAD_BAND;
366                                 free(sbb.iov.iov_base);
367                                         goto out;
368                         }
369                         n = sbb.iov.iov_len;
370                         PARA_INFO_LOG("<-- [challenge] (%zu bytes)\n", n);
371                         ret = priv_decrypt(ct->key_file, crypt_buf,
372                                 sbb.iov.iov_base, n);
373                         free(sbb.iov.iov_base);
374                         if (ret < 0)
375                                 goto out;
376                 } else {
377                         ret = client_recv_buffer(ct, &s->rfds, buf, sizeof(buf), &n);
378                         if (ret < 0 || n == 0)
379                                 goto out;
380                         PARA_INFO_LOG("<-- [challenge] (%zu bytes)\n", n);
381                         ret = priv_decrypt(ct->key_file, crypt_buf,
382                                 (unsigned char *)buf, n);
383                         if (ret < 0)
384                                 goto out;
385                 }
386                 ct->challenge_hash = para_malloc(HASH_SIZE);
387                 hash_function((char *)crypt_buf, CHALLENGE_SIZE, ct->challenge_hash);
388                 ct->scc.send = sc_new(crypt_buf + CHALLENGE_SIZE, SESSION_KEY_LEN);
389                 ct->scc.recv = sc_new(crypt_buf + CHALLENGE_SIZE + SESSION_KEY_LEN,
390                         SESSION_KEY_LEN);
391                 hash_to_asc(ct->challenge_hash, buf);
392                 PARA_INFO_LOG("--> %s\n", buf);
393                 ct->status = CL_RECEIVED_CHALLENGE;
394                 return;
395                 }
396         case CL_RECEIVED_CHALLENGE:
397                 if (ct->use_sideband) {
398                         ret = send_sb(ct, ct->challenge_hash, HASH_SIZE,
399                                 SBD_CHALLENGE_RESPONSE, false);
400                         if (ret != 0)
401                                 ct->challenge_hash = NULL;
402                         if (ret <= 0)
403                                 goto out;
404                 } else {
405                         ret = write_all(ct->scc.fd, (char *)ct->challenge_hash, HASH_SIZE);
406                         if (ret < 0)
407                                 goto out;
408                 }
409                 ct->status = CL_SENT_CH_RESPONSE;
410                 goto out;
411         case CL_SENT_CH_RESPONSE: /* read server response */
412                 {
413                 if (ct->use_sideband) {
414                         struct sb_buffer sbb;
415                         ret = recv_sb(ct, &s->rfds, &sbb);
416                         if (ret <= 0)
417                                 goto out;
418                         free(sbb.iov.iov_base);
419                         if (sbb.band != SBD_PROCEED)
420                                 ret = -E_BAD_BAND;
421                         else
422                                 ct->status = CL_RECEIVED_PROCEED;
423                         goto out;
424                 }
425                 ret = client_recv_buffer(ct, &s->rfds, buf, sizeof(buf), &n);
426                 if (ret < 0 || n == 0)
427                         goto out;
428                 /* check if server has sent "Proceed" message */
429                 ret = -E_CLIENT_AUTH;
430                 if (n < PROCEED_MSG_LEN)
431                         goto out;
432                 if (!strstr(buf, PROCEED_MSG))
433                         goto out;
434                 ct->status = CL_RECEIVED_PROCEED;
435                 return;
436                 }
437         case CL_RECEIVED_PROCEED: /* concat args and send command */
438                 {
439                 int i;
440                 char *command = NULL;
441                 if (!FD_ISSET(ct->scc.fd, &s->wfds))
442                         return;
443                 if (ct->use_sideband) {
444                         ret = send_sb_command(ct);
445                         if (ret <= 0)
446                                 goto out;
447                         ct->status = CL_SENT_COMMAND;
448                         return;
449                 }
450                 for (i = 0; i < ct->conf.inputs_num; i++) {
451                         char *tmp = command;
452                         command = make_message("%s\n%s", command?
453                                 command : "", ct->conf.inputs[i]);
454                         free(tmp);
455                 }
456                 command = para_strcat(command, EOC_MSG "\n");
457                 PARA_DEBUG_LOG("--> %s\n", command);
458                 ret = sc_send_buffer(&ct->scc, command);
459                 free(command);
460                 if (ret < 0)
461                         goto out;
462                 ct->status = CL_SENT_COMMAND;
463                 return;
464                 }
465         case CL_SENT_COMMAND:
466                 {
467                 char *buf2;
468                 if (ct->use_sideband) {
469                         struct sb_buffer sbb;
470                         ret = recv_sb(ct, &s->rfds, &sbb);
471                         if (ret <= 0)
472                                 goto out;
473                         if (sbb.band == SBD_AWAITING_DATA) {
474                                 ct->status = CL_SENDING;
475                                 free(sbb.iov.iov_base);
476                                 goto out;
477                         }
478                         ct->status = CL_RECEIVING;
479                         ret = dispatch_sbb(ct, &sbb);
480                         goto out;
481                 }
482                 /* can not use "buf" here because we need a malloced buffer */
483                 buf2 = para_malloc(CLIENT_BUFSIZE);
484                 ret = client_recv_buffer(ct, &s->rfds, buf2, CLIENT_BUFSIZE, &n);
485                 if (n > 0) {
486                         if (strstr(buf2, AWAITING_DATA_MSG)) {
487                                 free(buf2);
488                                 ct->status = CL_SENDING;
489                                 return;
490                         }
491                         ct->status = CL_RECEIVING;
492                         btr_add_output(buf2, n, btrn);
493                 } else
494                         free(buf2);
495                 goto out;
496                 }
497         case CL_SENDING:
498                 {
499                 char *buf2;
500                 size_t sz;
501                 ret = btr_node_status(btrn, 0, BTR_NT_LEAF);
502                 if (ret < 0)
503                         goto out;
504                 if (ret == 0)
505                         return;
506                 if (!FD_ISSET(ct->scc.fd, &s->wfds))
507                         return;
508                 sz = btr_next_buffer(btrn, &buf2);
509                 ret = sc_send_bin_buffer(&ct->scc, buf2, sz);
510                 if (ret < 0)
511                         goto out;
512                 btr_consume(btrn, sz);
513                 return;
514                 }
515         case CL_RECEIVING:
516                 {
517                 char *buf2;
518                 ret = btr_node_status(btrn, 0, BTR_NT_ROOT);
519                 if (ret < 0)
520                         goto out;
521                 if (ret == 0)
522                         return;
523                 /*
524                  * The FD_ISSET() is not strictly necessary, but is allows us
525                  * to skip the malloc below if there is nothing to read anyway.
526                  */
527                 if (!FD_ISSET(ct->scc.fd, &s->rfds))
528                         return;
529                 if (ct->use_sideband) {
530                         struct sb_buffer sbb;
531                         ret = recv_sb(ct, &s->rfds, &sbb);
532                         if (ret > 0)
533                                 ret = dispatch_sbb(ct, &sbb);
534                         goto out;
535                 }
536                 buf2 = para_malloc(CLIENT_BUFSIZE);
537                 ret = client_recv_buffer(ct, &s->rfds, buf2, CLIENT_BUFSIZE, &n);
538                 if (n > 0) {
539                         buf2 = para_realloc(buf2, n);
540                         btr_add_output(buf2, n, btrn);
541                 } else
542                         free(buf2);
543                 goto out;
544                 }
545         }
546 out:
547         t->error = ret;
548         if (ret < 0) {
549                 if (ret != -E_SERVER_EOF && ret != -E_BTR_EOF && ret != -E_EOF)
550                         PARA_ERROR_LOG("%s\n", para_strerror(-t->error));
551                 btr_remove_node(btrn);
552         }
553 }
554
555 /**
556  * Connect to para_server and register the client task.
557  *
558  * \param ct The initialized client task structure.
559  * \param s The scheduler instance to register the client task to.
560  * \param parent The parent node of the client btr node.
561  * \param child The child node of the client node.
562  *
563  * The client task structure given by \a ct  must be allocated and initialized
564  * by \ref client_parse_config() before this function is called.
565  *
566  * \return Standard.
567  */
568 int client_connect(struct client_task *ct, struct sched *s,
569                 struct btr_node *parent, struct btr_node *child)
570 {
571         int ret;
572
573         PARA_NOTICE_LOG("connecting %s:%d\n", ct->conf.hostname_arg,
574                 ct->conf.server_port_arg);
575         ct->scc.fd = -1;
576         ret = para_connect_simple(IPPROTO_TCP, ct->conf.hostname_arg,
577                                                ct->conf.server_port_arg);
578         if (ret < 0)
579                 return ret;
580         ct->scc.fd = ret;
581         ret = mark_fd_nonblocking(ct->scc.fd);
582         if (ret < 0)
583                 goto err_out;
584         ct->status = CL_CONNECTED;
585         ct->btrn = btr_new_node(&(struct btr_node_description)
586                 EMBRACE(.name = "client", .parent = parent, .child = child));
587         ct->task.pre_select = client_pre_select;
588         ct->task.post_select = client_post_select;
589         ct->task.error = 0;
590         sprintf(ct->task.status, "client");
591         register_task(s, &ct->task);
592         return 1;
593 err_out:
594         close(ct->scc.fd);
595         ct->scc.fd = -1;
596         return ret;
597 }
598
599 /**
600  * Parse a client configuration.
601  *
602  * \param argc Usual argument count.
603  * \param argv Usual argument vector.
604  * \param ct_ptr Filled in by this function.
605  * \param loglevel If not \p NULL, the number of the loglevel is stored here.
606  *
607  * This checks the command line options given by \a argc and \a argv, sets
608  * default values for the user name and the name of the rsa key file and reads
609  * further options from the config file.
610  *
611  * Upon successful return, \a ct_ptr points to a dynamically allocated and
612  * initialized client task struct.
613  *
614  * \return The number of non-option arguments in \a argc/argv on success,
615  * negative on errors.
616  */
617 int client_parse_config(int argc, char *argv[], struct client_task **ct_ptr,
618                 int *loglevel)
619 {
620         char *home = para_homedir();
621         int ret;
622         struct client_task *ct = para_calloc(sizeof(struct client_task));
623
624         *ct_ptr = ct;
625         ct->scc.fd = -1;
626         ret = -E_CLIENT_SYNTAX;
627         if (client_cmdline_parser(argc, argv, &ct->conf))
628                 goto out;
629         HANDLE_VERSION_FLAG("client", ct->conf);
630
631         ct->config_file = ct->conf.config_file_given?
632                 para_strdup(ct->conf.config_file_arg) :
633                 make_message("%s/.paraslash/client.conf", home);
634         ret = file_exists(ct->config_file);
635         if (!ret && ct->conf.config_file_given) {
636                 ret = -E_NO_CONFIG;
637                 goto out;
638         }
639         if (ret) {
640                 struct client_cmdline_parser_params params = {
641                         .override = 0,
642                         .initialize = 0,
643                         .check_required = 0,
644                         .check_ambiguity = 0,
645                         .print_errors = 0
646                 };
647                 ret = -E_BAD_CONFIG;
648                 if (client_cmdline_parser_config_file(ct->config_file,
649                         &ct->conf, &params))
650                         goto out;
651         }
652         ct->user = ct->conf.user_given?
653                 para_strdup(ct->conf.user_arg) : para_logname();
654
655         if (ct->conf.key_file_given)
656                 ct->key_file = para_strdup(ct->conf.key_file_arg);
657         else {
658                 ct->key_file = make_message("%s/.paraslash/key.%s",
659                         home, ct->user);
660                 if (!file_exists(ct->key_file)) {
661                         free(ct->key_file);
662                         ct->key_file = make_message("%s/.ssh/id_rsa", home);
663                 }
664         }
665
666         if (loglevel)
667                 *loglevel = get_loglevel_by_name(ct->conf.loglevel_arg);
668         PARA_INFO_LOG("loglevel: %s\n", ct->conf.loglevel_arg);
669         PARA_INFO_LOG("config_file: %s\n", ct->config_file);
670         PARA_INFO_LOG("key_file: %s\n", ct->key_file);
671         ret = ct->conf.inputs_num;
672 out:
673         free(home);
674         if (ret < 0) {
675                 PARA_ERROR_LOG("%s\n", para_strerror(-ret));
676                 client_close(ct);
677                 *ct_ptr = NULL;
678         }
679         return ret;
680 }
681
682 /**
683  * Parse the client configuration and open a connection to para_server.
684  *
685  * \param argc See \ref client_parse_config.
686  * \param argv See \ref client_parse_config.
687  * \param ct_ptr See \ref client_parse_config.
688  * \param loglevel See \ref client_parse_config.
689  * \param parent See \ref client_connect().
690  * \param child See \ref client_connect().
691  * \param sched See \ref client_connect().
692  *
693  * This function combines client_parse_config() and client_connect(). It is
694  * considered a syntax error if no command was given, i.e. if the number
695  * of non-option arguments is zero.
696  *
697  * \return Standard.
698  */
699 int client_open(int argc, char *argv[], struct client_task **ct_ptr,
700                 int *loglevel, struct btr_node *parent, struct btr_node *child,
701                 struct sched *sched)
702 {
703         int ret = client_parse_config(argc, argv, ct_ptr, loglevel);
704
705         if (ret < 0)
706                 return ret;
707         if (ret == 0) {
708                 ret = -E_CLIENT_SYNTAX;
709                 goto fail;
710         }
711         ret = client_connect(*ct_ptr, sched, parent, child);
712         if (ret < 0)
713                 goto fail;
714         return 1;
715 fail:
716         client_close(*ct_ptr);
717         *ct_ptr = NULL;
718         return ret;
719 }