client_common.c

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