1
/* -*- coding: utf-8 -*- */
3
* Mandos-client - get and decrypt data from a Mandos server
5
* This program is partly derived from an example program for an Avahi
6
* service browser, downloaded from
7
* <http://avahi.org/browser/examples/core-browse-services.c>. This
8
* includes the following functions: "resolve_callback",
9
* "browse_callback", and parts of "main".
12
* Copyright © 2008-2011 Teddy Hogeborn
13
* Copyright © 2008-2011 Björn Påhlsson
15
* This program is free software: you can redistribute it and/or
16
* modify it under the terms of the GNU General Public License as
17
* published by the Free Software Foundation, either version 3 of the
18
* License, or (at your option) any later version.
20
* This program is distributed in the hope that it will be useful, but
21
* WITHOUT ANY WARRANTY; without even the implied warranty of
22
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
23
* General Public License for more details.
25
* You should have received a copy of the GNU General Public License
26
* along with this program. If not, see
27
* <http://www.gnu.org/licenses/>.
29
* Contact the authors at <mandos@recompile.se>.
32
/* Needed by GPGME, specifically gpgme_data_seek() */
33
#ifndef _LARGEFILE_SOURCE
34
#define _LARGEFILE_SOURCE
36
#ifndef _FILE_OFFSET_BITS
37
#define _FILE_OFFSET_BITS 64
40
#define _GNU_SOURCE /* TEMP_FAILURE_RETRY(), asprintf() */
42
#include <stdio.h> /* fprintf(), stderr, fwrite(),
43
stdout, ferror(), remove() */
44
#include <stdint.h> /* uint16_t, uint32_t */
45
#include <stddef.h> /* NULL, size_t, ssize_t */
46
#include <stdlib.h> /* free(), EXIT_SUCCESS, srand(),
48
#include <stdbool.h> /* bool, false, true */
49
#include <string.h> /* memset(), strcmp(), strlen(),
50
strerror(), asprintf(), strcpy() */
51
#include <sys/ioctl.h> /* ioctl */
52
#include <sys/types.h> /* socket(), inet_pton(), sockaddr,
53
sockaddr_in6, PF_INET6,
54
SOCK_STREAM, uid_t, gid_t, open(),
56
#include <sys/stat.h> /* open() */
57
#include <sys/socket.h> /* socket(), struct sockaddr_in6,
58
inet_pton(), connect() */
59
#include <fcntl.h> /* open() */
60
#include <dirent.h> /* opendir(), struct dirent, readdir()
62
#include <inttypes.h> /* PRIu16, PRIdMAX, intmax_t,
64
#include <assert.h> /* assert() */
65
#include <errno.h> /* perror(), errno,
66
program_invocation_short_name */
67
#include <time.h> /* nanosleep(), time(), sleep() */
68
#include <net/if.h> /* ioctl, ifreq, SIOCGIFFLAGS, IFF_UP,
69
SIOCSIFFLAGS, if_indextoname(),
70
if_nametoindex(), IF_NAMESIZE */
71
#include <netinet/in.h> /* IN6_IS_ADDR_LINKLOCAL,
72
INET_ADDRSTRLEN, INET6_ADDRSTRLEN
74
#include <unistd.h> /* close(), SEEK_SET, off_t, write(),
75
getuid(), getgid(), seteuid(),
77
#include <arpa/inet.h> /* inet_pton(), htons, inet_ntop() */
78
#include <iso646.h> /* not, or, and */
79
#include <argp.h> /* struct argp_option, error_t, struct
80
argp_state, struct argp,
81
argp_parse(), ARGP_KEY_ARG,
82
ARGP_KEY_END, ARGP_ERR_UNKNOWN */
83
#include <signal.h> /* sigemptyset(), sigaddset(),
84
sigaction(), SIGTERM, sig_atomic_t,
86
#include <sysexits.h> /* EX_OSERR, EX_USAGE, EX_UNAVAILABLE,
87
EX_NOHOST, EX_IOERR, EX_PROTOCOL */
90
#include <sys/klog.h> /* klogctl() */
91
#endif /* __linux__ */
94
/* All Avahi types, constants and functions
97
#include <avahi-core/core.h>
98
#include <avahi-core/lookup.h>
99
#include <avahi-core/log.h>
100
#include <avahi-common/simple-watch.h>
101
#include <avahi-common/malloc.h>
102
#include <avahi-common/error.h>
105
#include <gnutls/gnutls.h> /* All GnuTLS types, constants and
108
init_gnutls_session(),
110
#include <gnutls/openpgp.h>
111
/* gnutls_certificate_set_openpgp_key_file(),
112
GNUTLS_OPENPGP_FMT_BASE64 */
115
#include <gpgme.h> /* All GPGME types, constants and
118
GPGME_PROTOCOL_OpenPGP,
121
#define BUFFER_SIZE 256
123
#define PATHDIR "/conf/conf.d/mandos"
124
#define SECKEY "seckey.txt"
125
#define PUBKEY "pubkey.txt"
128
static const char mandos_protocol_version[] = "1";
129
const char *argp_program_version = "mandos-client " VERSION;
130
const char *argp_program_bug_address = "<mandos@recompile.se>";
131
static const char sys_class_net[] = "/sys/class/net";
132
char *connect_to = NULL;
134
/* Doubly linked list that need to be circularly linked when used */
135
typedef struct server{
138
AvahiIfIndex if_index;
140
struct timespec last_seen;
145
/* Used for passing in values through the Avahi callback functions */
147
AvahiSimplePoll *simple_poll;
149
gnutls_certificate_credentials_t cred;
150
unsigned int dh_bits;
151
gnutls_dh_params_t dh_params;
152
const char *priority;
154
server *current_server;
157
/* global context so signal handler can reach it*/
158
mandos_context mc = { .simple_poll = NULL, .server = NULL,
159
.dh_bits = 1024, .priority = "SECURE256"
160
":!CTYPE-X.509:+CTYPE-OPENPGP",
161
.current_server = NULL };
163
sig_atomic_t quit_now = 0;
164
int signal_received = 0;
166
/* Function to use when printing errors */
167
void perror_plus(const char *print_text){
168
fprintf(stderr, "Mandos plugin %s: ",
169
program_invocation_short_name);
174
* Make additional room in "buffer" for at least BUFFER_SIZE more
175
* bytes. "buffer_capacity" is how much is currently allocated,
176
* "buffer_length" is how much is already used.
178
size_t incbuffer(char **buffer, size_t buffer_length,
179
size_t buffer_capacity){
180
if(buffer_length + BUFFER_SIZE > buffer_capacity){
181
*buffer = realloc(*buffer, buffer_capacity + BUFFER_SIZE);
185
buffer_capacity += BUFFER_SIZE;
187
return buffer_capacity;
190
/* Add server to set of servers to retry periodically */
191
int add_server(const char *ip, uint16_t port,
192
AvahiIfIndex if_index,
195
server *new_server = malloc(sizeof(server));
196
if(new_server == NULL){
197
perror_plus("malloc");
200
*new_server = (server){ .ip = strdup(ip),
202
.if_index = if_index,
204
if(new_server->ip == NULL){
205
perror_plus("strdup");
208
/* Special case of first server */
209
if (mc.current_server == NULL){
210
new_server->next = new_server;
211
new_server->prev = new_server;
212
mc.current_server = new_server;
213
/* Place the new server last in the list */
215
new_server->next = mc.current_server;
216
new_server->prev = mc.current_server->prev;
217
new_server->prev->next = new_server;
218
mc.current_server->prev = new_server;
220
ret = clock_gettime(CLOCK_MONOTONIC, &mc.current_server->last_seen);
222
perror_plus("clock_gettime");
231
static bool init_gpgme(const char *seckey,
232
const char *pubkey, const char *tempdir){
234
gpgme_engine_info_t engine_info;
238
* Helper function to insert pub and seckey to the engine keyring.
240
bool import_key(const char *filename){
243
gpgme_data_t pgp_data;
245
fd = (int)TEMP_FAILURE_RETRY(open(filename, O_RDONLY));
251
rc = gpgme_data_new_from_fd(&pgp_data, fd);
252
if(rc != GPG_ERR_NO_ERROR){
253
fprintf(stderr, "bad gpgme_data_new_from_fd: %s: %s\n",
254
gpgme_strsource(rc), gpgme_strerror(rc));
258
rc = gpgme_op_import(mc.ctx, pgp_data);
259
if(rc != GPG_ERR_NO_ERROR){
260
fprintf(stderr, "bad gpgme_op_import: %s: %s\n",
261
gpgme_strsource(rc), gpgme_strerror(rc));
265
ret = (int)TEMP_FAILURE_RETRY(close(fd));
267
perror_plus("close");
269
gpgme_data_release(pgp_data);
274
fprintf(stderr, "Initializing GPGME\n");
278
gpgme_check_version(NULL);
279
rc = gpgme_engine_check_version(GPGME_PROTOCOL_OpenPGP);
280
if(rc != GPG_ERR_NO_ERROR){
281
fprintf(stderr, "bad gpgme_engine_check_version: %s: %s\n",
282
gpgme_strsource(rc), gpgme_strerror(rc));
286
/* Set GPGME home directory for the OpenPGP engine only */
287
rc = gpgme_get_engine_info(&engine_info);
288
if(rc != GPG_ERR_NO_ERROR){
289
fprintf(stderr, "bad gpgme_get_engine_info: %s: %s\n",
290
gpgme_strsource(rc), gpgme_strerror(rc));
293
while(engine_info != NULL){
294
if(engine_info->protocol == GPGME_PROTOCOL_OpenPGP){
295
gpgme_set_engine_info(GPGME_PROTOCOL_OpenPGP,
296
engine_info->file_name, tempdir);
299
engine_info = engine_info->next;
301
if(engine_info == NULL){
302
fprintf(stderr, "Could not set GPGME home dir to %s\n", tempdir);
306
/* Create new GPGME "context" */
307
rc = gpgme_new(&(mc.ctx));
308
if(rc != GPG_ERR_NO_ERROR){
309
fprintf(stderr, "bad gpgme_new: %s: %s\n",
310
gpgme_strsource(rc), gpgme_strerror(rc));
314
if(not import_key(pubkey) or not import_key(seckey)){
322
* Decrypt OpenPGP data.
323
* Returns -1 on error
325
static ssize_t pgp_packet_decrypt(const char *cryptotext,
328
gpgme_data_t dh_crypto, dh_plain;
331
size_t plaintext_capacity = 0;
332
ssize_t plaintext_length = 0;
335
fprintf(stderr, "Trying to decrypt OpenPGP data\n");
338
/* Create new GPGME data buffer from memory cryptotext */
339
rc = gpgme_data_new_from_mem(&dh_crypto, cryptotext, crypto_size,
341
if(rc != GPG_ERR_NO_ERROR){
342
fprintf(stderr, "bad gpgme_data_new_from_mem: %s: %s\n",
343
gpgme_strsource(rc), gpgme_strerror(rc));
347
/* Create new empty GPGME data buffer for the plaintext */
348
rc = gpgme_data_new(&dh_plain);
349
if(rc != GPG_ERR_NO_ERROR){
350
fprintf(stderr, "bad gpgme_data_new: %s: %s\n",
351
gpgme_strsource(rc), gpgme_strerror(rc));
352
gpgme_data_release(dh_crypto);
356
/* Decrypt data from the cryptotext data buffer to the plaintext
358
rc = gpgme_op_decrypt(mc.ctx, dh_crypto, dh_plain);
359
if(rc != GPG_ERR_NO_ERROR){
360
fprintf(stderr, "bad gpgme_op_decrypt: %s: %s\n",
361
gpgme_strsource(rc), gpgme_strerror(rc));
362
plaintext_length = -1;
364
gpgme_decrypt_result_t result;
365
result = gpgme_op_decrypt_result(mc.ctx);
367
fprintf(stderr, "gpgme_op_decrypt_result failed\n");
369
fprintf(stderr, "Unsupported algorithm: %s\n",
370
result->unsupported_algorithm);
371
fprintf(stderr, "Wrong key usage: %u\n",
372
result->wrong_key_usage);
373
if(result->file_name != NULL){
374
fprintf(stderr, "File name: %s\n", result->file_name);
376
gpgme_recipient_t recipient;
377
recipient = result->recipients;
378
while(recipient != NULL){
379
fprintf(stderr, "Public key algorithm: %s\n",
380
gpgme_pubkey_algo_name(recipient->pubkey_algo));
381
fprintf(stderr, "Key ID: %s\n", recipient->keyid);
382
fprintf(stderr, "Secret key available: %s\n",
383
recipient->status == GPG_ERR_NO_SECKEY
385
recipient = recipient->next;
393
fprintf(stderr, "Decryption of OpenPGP data succeeded\n");
396
/* Seek back to the beginning of the GPGME plaintext data buffer */
397
if(gpgme_data_seek(dh_plain, (off_t)0, SEEK_SET) == -1){
398
perror_plus("gpgme_data_seek");
399
plaintext_length = -1;
405
plaintext_capacity = incbuffer(plaintext,
406
(size_t)plaintext_length,
408
if(plaintext_capacity == 0){
409
perror_plus("incbuffer");
410
plaintext_length = -1;
414
ret = gpgme_data_read(dh_plain, *plaintext + plaintext_length,
416
/* Print the data, if any */
422
perror_plus("gpgme_data_read");
423
plaintext_length = -1;
426
plaintext_length += ret;
430
fprintf(stderr, "Decrypted password is: ");
431
for(ssize_t i = 0; i < plaintext_length; i++){
432
fprintf(stderr, "%02hhX ", (*plaintext)[i]);
434
fprintf(stderr, "\n");
439
/* Delete the GPGME cryptotext data buffer */
440
gpgme_data_release(dh_crypto);
442
/* Delete the GPGME plaintext data buffer */
443
gpgme_data_release(dh_plain);
444
return plaintext_length;
447
static const char * safer_gnutls_strerror(int value){
448
const char *ret = gnutls_strerror(value); /* Spurious warning from
449
-Wunreachable-code */
455
/* GnuTLS log function callback */
456
static void debuggnutls(__attribute__((unused)) int level,
458
fprintf(stderr, "GnuTLS: %s", string);
461
static int init_gnutls_global(const char *pubkeyfilename,
462
const char *seckeyfilename){
466
fprintf(stderr, "Initializing GnuTLS\n");
469
ret = gnutls_global_init();
470
if(ret != GNUTLS_E_SUCCESS){
471
fprintf(stderr, "GnuTLS global_init: %s\n",
472
safer_gnutls_strerror(ret));
477
/* "Use a log level over 10 to enable all debugging options."
480
gnutls_global_set_log_level(11);
481
gnutls_global_set_log_function(debuggnutls);
484
/* OpenPGP credentials */
485
ret = gnutls_certificate_allocate_credentials(&mc.cred);
486
if(ret != GNUTLS_E_SUCCESS){
487
fprintf(stderr, "GnuTLS memory error: %s\n",
488
safer_gnutls_strerror(ret));
489
gnutls_global_deinit();
494
fprintf(stderr, "Attempting to use OpenPGP public key %s and"
495
" secret key %s as GnuTLS credentials\n", pubkeyfilename,
499
ret = gnutls_certificate_set_openpgp_key_file
500
(mc.cred, pubkeyfilename, seckeyfilename,
501
GNUTLS_OPENPGP_FMT_BASE64);
502
if(ret != GNUTLS_E_SUCCESS){
504
"Error[%d] while reading the OpenPGP key pair ('%s',"
505
" '%s')\n", ret, pubkeyfilename, seckeyfilename);
506
fprintf(stderr, "The GnuTLS error is: %s\n",
507
safer_gnutls_strerror(ret));
511
/* GnuTLS server initialization */
512
ret = gnutls_dh_params_init(&mc.dh_params);
513
if(ret != GNUTLS_E_SUCCESS){
514
fprintf(stderr, "Error in GnuTLS DH parameter initialization:"
515
" %s\n", safer_gnutls_strerror(ret));
518
ret = gnutls_dh_params_generate2(mc.dh_params, mc.dh_bits);
519
if(ret != GNUTLS_E_SUCCESS){
520
fprintf(stderr, "Error in GnuTLS prime generation: %s\n",
521
safer_gnutls_strerror(ret));
525
gnutls_certificate_set_dh_params(mc.cred, mc.dh_params);
531
gnutls_certificate_free_credentials(mc.cred);
532
gnutls_global_deinit();
533
gnutls_dh_params_deinit(mc.dh_params);
537
static int init_gnutls_session(gnutls_session_t *session){
539
/* GnuTLS session creation */
541
ret = gnutls_init(session, GNUTLS_SERVER);
545
} while(ret == GNUTLS_E_INTERRUPTED or ret == GNUTLS_E_AGAIN);
546
if(ret != GNUTLS_E_SUCCESS){
547
fprintf(stderr, "Error in GnuTLS session initialization: %s\n",
548
safer_gnutls_strerror(ret));
554
ret = gnutls_priority_set_direct(*session, mc.priority, &err);
556
gnutls_deinit(*session);
559
} while(ret == GNUTLS_E_INTERRUPTED or ret == GNUTLS_E_AGAIN);
560
if(ret != GNUTLS_E_SUCCESS){
561
fprintf(stderr, "Syntax error at: %s\n", err);
562
fprintf(stderr, "GnuTLS error: %s\n",
563
safer_gnutls_strerror(ret));
564
gnutls_deinit(*session);
570
ret = gnutls_credentials_set(*session, GNUTLS_CRD_CERTIFICATE,
573
gnutls_deinit(*session);
576
} while(ret == GNUTLS_E_INTERRUPTED or ret == GNUTLS_E_AGAIN);
577
if(ret != GNUTLS_E_SUCCESS){
578
fprintf(stderr, "Error setting GnuTLS credentials: %s\n",
579
safer_gnutls_strerror(ret));
580
gnutls_deinit(*session);
584
/* ignore client certificate if any. */
585
gnutls_certificate_server_set_request(*session, GNUTLS_CERT_IGNORE);
587
gnutls_dh_set_prime_bits(*session, mc.dh_bits);
592
/* Avahi log function callback */
593
static void empty_log(__attribute__((unused)) AvahiLogLevel level,
594
__attribute__((unused)) const char *txt){}
596
/* Called when a Mandos server is found */
597
static int start_mandos_communication(const char *ip, uint16_t port,
598
AvahiIfIndex if_index,
600
int ret, tcp_sd = -1;
603
struct sockaddr_in in;
604
struct sockaddr_in6 in6;
607
char *decrypted_buffer = NULL;
608
size_t buffer_length = 0;
609
size_t buffer_capacity = 0;
612
gnutls_session_t session;
613
int pf; /* Protocol family */
630
fprintf(stderr, "Bad address family: %d\n", af);
635
ret = init_gnutls_session(&session);
641
fprintf(stderr, "Setting up a TCP connection to %s, port %" PRIu16
645
tcp_sd = socket(pf, SOCK_STREAM, 0);
648
perror_plus("socket");
658
memset(&to, 0, sizeof(to));
660
to.in6.sin6_family = (sa_family_t)af;
661
ret = inet_pton(af, ip, &to.in6.sin6_addr);
663
to.in.sin_family = (sa_family_t)af;
664
ret = inet_pton(af, ip, &to.in.sin_addr);
668
perror_plus("inet_pton");
674
fprintf(stderr, "Bad address: %s\n", ip);
679
to.in6.sin6_port = htons(port); /* Spurious warnings from
681
-Wunreachable-code */
683
if(IN6_IS_ADDR_LINKLOCAL /* Spurious warnings from */
684
(&to.in6.sin6_addr)){ /* -Wstrict-aliasing=2 or lower and
686
if(if_index == AVAHI_IF_UNSPEC){
687
fprintf(stderr, "An IPv6 link-local address is incomplete"
688
" without a network interface\n");
692
/* Set the network interface number as scope */
693
to.in6.sin6_scope_id = (uint32_t)if_index;
696
to.in.sin_port = htons(port); /* Spurious warnings from
698
-Wunreachable-code */
707
if(af == AF_INET6 and if_index != AVAHI_IF_UNSPEC){
708
char interface[IF_NAMESIZE];
709
if(if_indextoname((unsigned int)if_index, interface) == NULL){
710
perror_plus("if_indextoname");
712
fprintf(stderr, "Connection to: %s%%%s, port %" PRIu16 "\n",
713
ip, interface, port);
716
fprintf(stderr, "Connection to: %s, port %" PRIu16 "\n", ip,
719
char addrstr[(INET_ADDRSTRLEN > INET6_ADDRSTRLEN) ?
720
INET_ADDRSTRLEN : INET6_ADDRSTRLEN] = "";
723
pcret = inet_ntop(af, &(to.in6.sin6_addr), addrstr,
726
pcret = inet_ntop(af, &(to.in.sin_addr), addrstr,
730
perror_plus("inet_ntop");
732
if(strcmp(addrstr, ip) != 0){
733
fprintf(stderr, "Canonical address form: %s\n", addrstr);
744
ret = connect(tcp_sd, &to.in6, sizeof(to));
746
ret = connect(tcp_sd, &to.in, sizeof(to)); /* IPv4 */
749
if ((errno != ECONNREFUSED and errno != ENETUNREACH) or debug){
751
perror_plus("connect");
762
const char *out = mandos_protocol_version;
765
size_t out_size = strlen(out);
766
ret = (int)TEMP_FAILURE_RETRY(write(tcp_sd, out + written,
767
out_size - written));
770
perror_plus("write");
774
written += (size_t)ret;
775
if(written < out_size){
778
if(out == mandos_protocol_version){
793
fprintf(stderr, "Establishing TLS session with %s\n", ip);
801
/* Spurious warning from -Wint-to-pointer-cast */
802
gnutls_transport_set_ptr(session, (gnutls_transport_ptr_t) tcp_sd);
810
ret = gnutls_handshake(session);
815
} while(ret == GNUTLS_E_AGAIN or ret == GNUTLS_E_INTERRUPTED);
817
if(ret != GNUTLS_E_SUCCESS){
819
fprintf(stderr, "*** GnuTLS Handshake failed ***\n");
826
/* Read OpenPGP packet that contains the wanted password */
829
fprintf(stderr, "Retrieving OpenPGP encrypted password from %s\n",
840
buffer_capacity = incbuffer(&buffer, buffer_length,
842
if(buffer_capacity == 0){
844
perror_plus("incbuffer");
854
sret = gnutls_record_recv(session, buffer+buffer_length,
861
case GNUTLS_E_INTERRUPTED:
864
case GNUTLS_E_REHANDSHAKE:
866
ret = gnutls_handshake(session);
872
} while(ret == GNUTLS_E_AGAIN or ret == GNUTLS_E_INTERRUPTED);
874
fprintf(stderr, "*** GnuTLS Re-handshake failed ***\n");
881
fprintf(stderr, "Unknown error while reading data from"
882
" encrypted session with Mandos server\n");
883
gnutls_bye(session, GNUTLS_SHUT_RDWR);
888
buffer_length += (size_t) sret;
893
fprintf(stderr, "Closing TLS session\n");
902
ret = gnutls_bye(session, GNUTLS_SHUT_RDWR);
907
} while(ret == GNUTLS_E_AGAIN or ret == GNUTLS_E_INTERRUPTED);
909
if(buffer_length > 0){
910
ssize_t decrypted_buffer_size;
911
decrypted_buffer_size = pgp_packet_decrypt(buffer,
914
if(decrypted_buffer_size >= 0){
917
while(written < (size_t) decrypted_buffer_size){
923
ret = (int)fwrite(decrypted_buffer + written, 1,
924
(size_t)decrypted_buffer_size - written,
926
if(ret == 0 and ferror(stdout)){
929
fprintf(stderr, "Error writing encrypted data: %s\n",
935
written += (size_t)ret;
941
/* Shutdown procedure */
946
free(decrypted_buffer);
949
ret = (int)TEMP_FAILURE_RETRY(close(tcp_sd));
955
perror_plus("close");
957
gnutls_deinit(session);
967
static void resolve_callback(AvahiSServiceResolver *r,
968
AvahiIfIndex interface,
970
AvahiResolverEvent event,
974
const char *host_name,
975
const AvahiAddress *address,
977
AVAHI_GCC_UNUSED AvahiStringList *txt,
978
AVAHI_GCC_UNUSED AvahiLookupResultFlags
980
AVAHI_GCC_UNUSED void* userdata){
983
/* Called whenever a service has been resolved successfully or
992
case AVAHI_RESOLVER_FAILURE:
993
fprintf(stderr, "(Avahi Resolver) Failed to resolve service '%s'"
994
" of type '%s' in domain '%s': %s\n", name, type, domain,
995
avahi_strerror(avahi_server_errno(mc.server)));
998
case AVAHI_RESOLVER_FOUND:
1000
char ip[AVAHI_ADDRESS_STR_MAX];
1001
avahi_address_snprint(ip, sizeof(ip), address);
1003
fprintf(stderr, "Mandos server \"%s\" found on %s (%s, %"
1004
PRIdMAX ") on port %" PRIu16 "\n", name, host_name,
1005
ip, (intmax_t)interface, port);
1007
int ret = start_mandos_communication(ip, port, interface,
1008
avahi_proto_to_af(proto));
1010
avahi_simple_poll_quit(mc.simple_poll);
1012
ret = add_server(ip, port, interface,
1013
avahi_proto_to_af(proto));
1017
avahi_s_service_resolver_free(r);
1020
static void browse_callback(AvahiSServiceBrowser *b,
1021
AvahiIfIndex interface,
1022
AvahiProtocol protocol,
1023
AvahiBrowserEvent event,
1027
AVAHI_GCC_UNUSED AvahiLookupResultFlags
1029
AVAHI_GCC_UNUSED void* userdata){
1032
/* Called whenever a new services becomes available on the LAN or
1033
is removed from the LAN */
1041
case AVAHI_BROWSER_FAILURE:
1043
fprintf(stderr, "(Avahi browser) %s\n",
1044
avahi_strerror(avahi_server_errno(mc.server)));
1045
avahi_simple_poll_quit(mc.simple_poll);
1048
case AVAHI_BROWSER_NEW:
1049
/* We ignore the returned Avahi resolver object. In the callback
1050
function we free it. If the Avahi server is terminated before
1051
the callback function is called the Avahi server will free the
1054
if(avahi_s_service_resolver_new(mc.server, interface, protocol,
1055
name, type, domain, protocol, 0,
1056
resolve_callback, NULL) == NULL)
1057
fprintf(stderr, "Avahi: Failed to resolve service '%s': %s\n",
1058
name, avahi_strerror(avahi_server_errno(mc.server)));
1061
case AVAHI_BROWSER_REMOVE:
1064
case AVAHI_BROWSER_ALL_FOR_NOW:
1065
case AVAHI_BROWSER_CACHE_EXHAUSTED:
1067
fprintf(stderr, "No Mandos server found, still searching...\n");
1073
/* Signal handler that stops main loop after SIGTERM */
1074
static void handle_sigterm(int sig){
1079
signal_received = sig;
1080
int old_errno = errno;
1081
/* set main loop to exit */
1082
if(mc.simple_poll != NULL){
1083
avahi_simple_poll_quit(mc.simple_poll);
1089
* This function determines if a directory entry in /sys/class/net
1090
* corresponds to an acceptable network device.
1091
* (This function is passed to scandir(3) as a filter function.)
1093
int good_interface(const struct dirent *if_entry){
1096
if(if_entry->d_name[0] == '.'){
1099
int s = socket(PF_INET6, SOCK_DGRAM, IPPROTO_IP);
1101
perror_plus("socket");
1105
strcpy(ifr.ifr_name, if_entry->d_name);
1106
ret = ioctl(s, SIOCGIFFLAGS, &ifr);
1109
perror_plus("ioctl SIOCGIFFLAGS");
1113
/* Reject the loopback device */
1114
if(ifr.ifr_flags & IFF_LOOPBACK){
1116
fprintf(stderr, "Rejecting loopback interface \"%s\"\n",
1121
/* Accept point-to-point devices only if connect_to is specified */
1122
if(connect_to != NULL and (ifr.ifr_flags & IFF_POINTOPOINT)){
1124
fprintf(stderr, "Accepting point-to-point interface \"%s\"\n",
1129
/* Otherwise, reject non-broadcast-capable devices */
1130
if(not (ifr.ifr_flags & IFF_BROADCAST)){
1132
fprintf(stderr, "Rejecting non-broadcast interface \"%s\"\n",
1137
/* Reject non-ARP interfaces (including dummy interfaces) */
1138
if(ifr.ifr_flags & IFF_NOARP){
1140
fprintf(stderr, "Rejecting non-ARP interface \"%s\"\n",
1145
/* Accept this device */
1147
fprintf(stderr, "Interface \"%s\" is acceptable\n",
1153
int notdotentries(const struct dirent *direntry){
1154
/* Skip "." and ".." */
1155
if(direntry->d_name[0] == '.'
1156
and (direntry->d_name[1] == '\0'
1157
or (direntry->d_name[1] == '.'
1158
and direntry->d_name[2] == '\0'))){
1164
int avahi_loop_with_timeout(AvahiSimplePoll *s, int retry_interval){
1166
struct timespec now;
1167
struct timespec waited_time;
1168
intmax_t block_time;
1171
if(mc.current_server == NULL){
1174
"Wait until first server is found. No timeout!\n");
1176
ret = avahi_simple_poll_iterate(s, -1);
1179
fprintf(stderr, "Check current_server if we should run it,"
1182
/* the current time */
1183
ret = clock_gettime(CLOCK_MONOTONIC, &now);
1185
perror_plus("clock_gettime");
1188
/* Calculating in ms how long time between now and server
1189
who we visted longest time ago. Now - last seen. */
1190
waited_time.tv_sec = (now.tv_sec
1191
- mc.current_server->last_seen.tv_sec);
1192
waited_time.tv_nsec = (now.tv_nsec
1193
- mc.current_server->last_seen.tv_nsec);
1194
/* total time is 10s/10,000ms.
1195
Converting to s from ms by dividing by 1,000,
1196
and ns to ms by dividing by 1,000,000. */
1197
block_time = ((retry_interval
1198
- ((intmax_t)waited_time.tv_sec * 1000))
1199
- ((intmax_t)waited_time.tv_nsec / 1000000));
1202
fprintf(stderr, "Blocking for %" PRIdMAX " ms\n", block_time);
1205
if(block_time <= 0){
1206
ret = start_mandos_communication(mc.current_server->ip,
1207
mc.current_server->port,
1208
mc.current_server->if_index,
1209
mc.current_server->af);
1211
avahi_simple_poll_quit(mc.simple_poll);
1214
ret = clock_gettime(CLOCK_MONOTONIC,
1215
&mc.current_server->last_seen);
1217
perror_plus("clock_gettime");
1220
mc.current_server = mc.current_server->next;
1221
block_time = 0; /* Call avahi to find new Mandos
1222
servers, but don't block */
1225
ret = avahi_simple_poll_iterate(s, (int)block_time);
1228
if (ret > 0 or errno != EINTR) {
1229
return (ret != 1) ? ret : 0;
1235
int main(int argc, char *argv[]){
1236
AvahiSServiceBrowser *sb = NULL;
1241
int exitcode = EXIT_SUCCESS;
1242
const char *interface = "";
1243
struct ifreq network;
1245
bool take_down_interface = false;
1248
char tempdir[] = "/tmp/mandosXXXXXX";
1249
bool tempdir_created = false;
1250
AvahiIfIndex if_index = AVAHI_IF_UNSPEC;
1251
const char *seckey = PATHDIR "/" SECKEY;
1252
const char *pubkey = PATHDIR "/" PUBKEY;
1254
bool gnutls_initialized = false;
1255
bool gpgme_initialized = false;
1257
double retry_interval = 10; /* 10s between trying a server and
1258
retrying the same server again */
1260
struct sigaction old_sigterm_action = { .sa_handler = SIG_DFL };
1261
struct sigaction sigterm_action = { .sa_handler = handle_sigterm };
1266
/* Lower any group privileges we might have, just to be safe */
1270
perror_plus("setgid");
1273
/* Lower user privileges (temporarily) */
1277
perror_plus("seteuid");
1285
struct argp_option options[] = {
1286
{ .name = "debug", .key = 128,
1287
.doc = "Debug mode", .group = 3 },
1288
{ .name = "connect", .key = 'c',
1289
.arg = "ADDRESS:PORT",
1290
.doc = "Connect directly to a specific Mandos server",
1292
{ .name = "interface", .key = 'i',
1294
.doc = "Network interface that will be used to search for"
1297
{ .name = "seckey", .key = 's',
1299
.doc = "OpenPGP secret key file base name",
1301
{ .name = "pubkey", .key = 'p',
1303
.doc = "OpenPGP public key file base name",
1305
{ .name = "dh-bits", .key = 129,
1307
.doc = "Bit length of the prime number used in the"
1308
" Diffie-Hellman key exchange",
1310
{ .name = "priority", .key = 130,
1312
.doc = "GnuTLS priority string for the TLS handshake",
1314
{ .name = "delay", .key = 131,
1316
.doc = "Maximum delay to wait for interface startup",
1318
{ .name = "retry", .key = 132,
1320
.doc = "Retry interval used when denied by the mandos server",
1323
* These reproduce what we would get without ARGP_NO_HELP
1325
{ .name = "help", .key = '?',
1326
.doc = "Give this help list", .group = -1 },
1327
{ .name = "usage", .key = -3,
1328
.doc = "Give a short usage message", .group = -1 },
1329
{ .name = "version", .key = 'V',
1330
.doc = "Print program version", .group = -1 },
1334
error_t parse_opt(int key, char *arg,
1335
struct argp_state *state){
1338
case 128: /* --debug */
1341
case 'c': /* --connect */
1344
case 'i': /* --interface */
1347
case 's': /* --seckey */
1350
case 'p': /* --pubkey */
1353
case 129: /* --dh-bits */
1355
tmpmax = strtoimax(arg, &tmp, 10);
1356
if(errno != 0 or tmp == arg or *tmp != '\0'
1357
or tmpmax != (typeof(mc.dh_bits))tmpmax){
1358
argp_error(state, "Bad number of DH bits");
1360
mc.dh_bits = (typeof(mc.dh_bits))tmpmax;
1362
case 130: /* --priority */
1365
case 131: /* --delay */
1367
delay = strtof(arg, &tmp);
1368
if(errno != 0 or tmp == arg or *tmp != '\0'){
1369
argp_error(state, "Bad delay");
1371
case 132: /* --retry */
1373
retry_interval = strtod(arg, &tmp);
1374
if(errno != 0 or tmp == arg or *tmp != '\0'
1375
or (retry_interval * 1000) > INT_MAX
1376
or retry_interval < 0){
1377
argp_error(state, "Bad retry interval");
1381
* These reproduce what we would get without ARGP_NO_HELP
1383
case '?': /* --help */
1384
argp_state_help(state, state->out_stream,
1385
(ARGP_HELP_STD_HELP | ARGP_HELP_EXIT_ERR)
1386
& ~(unsigned int)ARGP_HELP_EXIT_OK);
1387
case -3: /* --usage */
1388
argp_state_help(state, state->out_stream,
1389
ARGP_HELP_USAGE | ARGP_HELP_EXIT_ERR);
1390
case 'V': /* --version */
1391
fprintf(state->out_stream, "%s\n", argp_program_version);
1392
exit(argp_err_exit_status);
1395
return ARGP_ERR_UNKNOWN;
1400
struct argp argp = { .options = options, .parser = parse_opt,
1402
.doc = "Mandos client -- Get and decrypt"
1403
" passwords from a Mandos server" };
1404
ret = argp_parse(&argp, argc, argv,
1405
ARGP_IN_ORDER | ARGP_NO_HELP, 0, NULL);
1412
perror_plus("argp_parse");
1413
exitcode = EX_OSERR;
1416
exitcode = EX_USAGE;
1422
/* Work around Debian bug #633582:
1423
<http://bugs.debian.org/633582> */
1426
/* Re-raise priviliges */
1430
perror_plus("seteuid");
1433
if(strcmp(seckey, PATHDIR "/" SECKEY) == 0){
1434
int seckey_fd = open(seckey, O_RDONLY);
1435
if(seckey_fd == -1){
1436
perror_plus("open");
1438
ret = (int)TEMP_FAILURE_RETRY(fstat(seckey_fd, &st));
1440
perror_plus("fstat");
1442
if(S_ISREG(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
1443
ret = fchown(seckey_fd, uid, gid);
1445
perror_plus("fchown");
1449
TEMP_FAILURE_RETRY(close(seckey_fd));
1453
if(strcmp(pubkey, PATHDIR "/" PUBKEY) == 0){
1454
int pubkey_fd = open(pubkey, O_RDONLY);
1455
if(pubkey_fd == -1){
1456
perror_plus("open");
1458
ret = (int)TEMP_FAILURE_RETRY(fstat(pubkey_fd, &st));
1460
perror_plus("fstat");
1462
if(S_ISREG(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
1463
ret = fchown(pubkey_fd, uid, gid);
1465
perror_plus("fchown");
1469
TEMP_FAILURE_RETRY(close(pubkey_fd));
1473
/* Lower privileges */
1477
perror_plus("seteuid");
1482
avahi_set_log_function(empty_log);
1485
if(interface[0] == '\0'){
1486
struct dirent **direntries;
1487
ret = scandir(sys_class_net, &direntries, good_interface,
1490
/* Pick the first good interface */
1491
interface = strdup(direntries[0]->d_name);
1493
fprintf(stderr, "Using interface \"%s\"\n", interface);
1495
if(interface == NULL){
1496
perror_plus("malloc");
1498
exitcode = EXIT_FAILURE;
1504
fprintf(stderr, "Could not find a network interface\n");
1505
exitcode = EXIT_FAILURE;
1510
/* Initialize Avahi early so avahi_simple_poll_quit() can be called
1511
from the signal handler */
1512
/* Initialize the pseudo-RNG for Avahi */
1513
srand((unsigned int) time(NULL));
1514
mc.simple_poll = avahi_simple_poll_new();
1515
if(mc.simple_poll == NULL){
1516
fprintf(stderr, "Avahi: Failed to create simple poll object.\n");
1517
exitcode = EX_UNAVAILABLE;
1521
sigemptyset(&sigterm_action.sa_mask);
1522
ret = sigaddset(&sigterm_action.sa_mask, SIGINT);
1524
perror_plus("sigaddset");
1525
exitcode = EX_OSERR;
1528
ret = sigaddset(&sigterm_action.sa_mask, SIGHUP);
1530
perror_plus("sigaddset");
1531
exitcode = EX_OSERR;
1534
ret = sigaddset(&sigterm_action.sa_mask, SIGTERM);
1536
perror_plus("sigaddset");
1537
exitcode = EX_OSERR;
1540
/* Need to check if the handler is SIG_IGN before handling:
1541
| [[info:libc:Initial Signal Actions]] |
1542
| [[info:libc:Basic Signal Handling]] |
1544
ret = sigaction(SIGINT, NULL, &old_sigterm_action);
1546
perror_plus("sigaction");
1549
if(old_sigterm_action.sa_handler != SIG_IGN){
1550
ret = sigaction(SIGINT, &sigterm_action, NULL);
1552
perror_plus("sigaction");
1553
exitcode = EX_OSERR;
1557
ret = sigaction(SIGHUP, NULL, &old_sigterm_action);
1559
perror_plus("sigaction");
1562
if(old_sigterm_action.sa_handler != SIG_IGN){
1563
ret = sigaction(SIGHUP, &sigterm_action, NULL);
1565
perror_plus("sigaction");
1566
exitcode = EX_OSERR;
1570
ret = sigaction(SIGTERM, NULL, &old_sigterm_action);
1572
perror_plus("sigaction");
1575
if(old_sigterm_action.sa_handler != SIG_IGN){
1576
ret = sigaction(SIGTERM, &sigterm_action, NULL);
1578
perror_plus("sigaction");
1579
exitcode = EX_OSERR;
1584
/* If the interface is down, bring it up */
1585
if(strcmp(interface, "none") != 0){
1586
if_index = (AvahiIfIndex) if_nametoindex(interface);
1588
fprintf(stderr, "No such interface: \"%s\"\n", interface);
1589
exitcode = EX_UNAVAILABLE;
1597
/* Re-raise priviliges */
1601
perror_plus("seteuid");
1605
/* Lower kernel loglevel to KERN_NOTICE to avoid KERN_INFO
1606
messages about the network interface to mess up the prompt */
1607
ret = klogctl(8, NULL, 5);
1608
bool restore_loglevel = true;
1610
restore_loglevel = false;
1611
perror_plus("klogctl");
1613
#endif /* __linux__ */
1615
sd = socket(PF_INET6, SOCK_DGRAM, IPPROTO_IP);
1617
perror_plus("socket");
1618
exitcode = EX_OSERR;
1620
if(restore_loglevel){
1621
ret = klogctl(7, NULL, 0);
1623
perror_plus("klogctl");
1626
#endif /* __linux__ */
1627
/* Lower privileges */
1631
perror_plus("seteuid");
1635
strcpy(network.ifr_name, interface);
1636
ret = ioctl(sd, SIOCGIFFLAGS, &network);
1638
perror_plus("ioctl SIOCGIFFLAGS");
1640
if(restore_loglevel){
1641
ret = klogctl(7, NULL, 0);
1643
perror_plus("klogctl");
1646
#endif /* __linux__ */
1647
exitcode = EX_OSERR;
1648
/* Lower privileges */
1652
perror_plus("seteuid");
1656
if((network.ifr_flags & IFF_UP) == 0){
1657
network.ifr_flags |= IFF_UP;
1658
take_down_interface = true;
1659
ret = ioctl(sd, SIOCSIFFLAGS, &network);
1661
take_down_interface = false;
1662
perror_plus("ioctl SIOCSIFFLAGS +IFF_UP");
1663
exitcode = EX_OSERR;
1665
if(restore_loglevel){
1666
ret = klogctl(7, NULL, 0);
1668
perror_plus("klogctl");
1671
#endif /* __linux__ */
1672
/* Lower privileges */
1676
perror_plus("seteuid");
1681
/* Sleep checking until interface is running.
1682
Check every 0.25s, up to total time of delay */
1683
for(int i=0; i < delay * 4; i++){
1684
ret = ioctl(sd, SIOCGIFFLAGS, &network);
1686
perror_plus("ioctl SIOCGIFFLAGS");
1687
} else if(network.ifr_flags & IFF_RUNNING){
1690
struct timespec sleeptime = { .tv_nsec = 250000000 };
1691
ret = nanosleep(&sleeptime, NULL);
1692
if(ret == -1 and errno != EINTR){
1693
perror_plus("nanosleep");
1696
if(not take_down_interface){
1697
/* We won't need the socket anymore */
1698
ret = (int)TEMP_FAILURE_RETRY(close(sd));
1700
perror_plus("close");
1704
if(restore_loglevel){
1705
/* Restores kernel loglevel to default */
1706
ret = klogctl(7, NULL, 0);
1708
perror_plus("klogctl");
1711
#endif /* __linux__ */
1712
/* Lower privileges */
1714
if(take_down_interface){
1715
/* Lower privileges */
1718
perror_plus("seteuid");
1721
/* Lower privileges permanently */
1724
perror_plus("setuid");
1733
ret = init_gnutls_global(pubkey, seckey);
1735
fprintf(stderr, "init_gnutls_global failed\n");
1736
exitcode = EX_UNAVAILABLE;
1739
gnutls_initialized = true;
1746
if(mkdtemp(tempdir) == NULL){
1747
perror_plus("mkdtemp");
1750
tempdir_created = true;
1756
if(not init_gpgme(pubkey, seckey, tempdir)){
1757
fprintf(stderr, "init_gpgme failed\n");
1758
exitcode = EX_UNAVAILABLE;
1761
gpgme_initialized = true;
1768
if(connect_to != NULL){
1769
/* Connect directly, do not use Zeroconf */
1770
/* (Mainly meant for debugging) */
1771
char *address = strrchr(connect_to, ':');
1772
if(address == NULL){
1773
fprintf(stderr, "No colon in address\n");
1774
exitcode = EX_USAGE;
1784
tmpmax = strtoimax(address+1, &tmp, 10);
1785
if(errno != 0 or tmp == address+1 or *tmp != '\0'
1786
or tmpmax != (uint16_t)tmpmax){
1787
fprintf(stderr, "Bad port number\n");
1788
exitcode = EX_USAGE;
1796
port = (uint16_t)tmpmax;
1798
/* Colon in address indicates IPv6 */
1800
if(strchr(connect_to, ':') != NULL){
1802
/* Accept [] around IPv6 address - see RFC 5952 */
1803
if(connect_to[0] == '[' and address[-1] == ']')
1811
address = connect_to;
1817
while(not quit_now){
1818
ret = start_mandos_communication(address, port, if_index, af);
1819
if(quit_now or ret == 0){
1823
fprintf(stderr, "Retrying in %d seconds\n",
1824
(int)retry_interval);
1826
sleep((int)retry_interval);
1830
exitcode = EXIT_SUCCESS;
1841
AvahiServerConfig config;
1842
/* Do not publish any local Zeroconf records */
1843
avahi_server_config_init(&config);
1844
config.publish_hinfo = 0;
1845
config.publish_addresses = 0;
1846
config.publish_workstation = 0;
1847
config.publish_domain = 0;
1849
/* Allocate a new server */
1850
mc.server = avahi_server_new(avahi_simple_poll_get
1851
(mc.simple_poll), &config, NULL,
1854
/* Free the Avahi configuration data */
1855
avahi_server_config_free(&config);
1858
/* Check if creating the Avahi server object succeeded */
1859
if(mc.server == NULL){
1860
fprintf(stderr, "Failed to create Avahi server: %s\n",
1861
avahi_strerror(error));
1862
exitcode = EX_UNAVAILABLE;
1870
/* Create the Avahi service browser */
1871
sb = avahi_s_service_browser_new(mc.server, if_index,
1872
AVAHI_PROTO_UNSPEC, "_mandos._tcp",
1873
NULL, 0, browse_callback, NULL);
1875
fprintf(stderr, "Failed to create service browser: %s\n",
1876
avahi_strerror(avahi_server_errno(mc.server)));
1877
exitcode = EX_UNAVAILABLE;
1885
/* Run the main loop */
1888
fprintf(stderr, "Starting Avahi loop search\n");
1891
ret = avahi_loop_with_timeout(mc.simple_poll,
1892
(int)(retry_interval * 1000));
1894
fprintf(stderr, "avahi_loop_with_timeout exited %s\n",
1895
(ret == 0) ? "successfully" : "with error");
1901
fprintf(stderr, "%s exiting\n", argv[0]);
1904
/* Cleanup things */
1906
avahi_s_service_browser_free(sb);
1908
if(mc.server != NULL)
1909
avahi_server_free(mc.server);
1911
if(mc.simple_poll != NULL)
1912
avahi_simple_poll_free(mc.simple_poll);
1914
if(gnutls_initialized){
1915
gnutls_certificate_free_credentials(mc.cred);
1916
gnutls_global_deinit();
1917
gnutls_dh_params_deinit(mc.dh_params);
1920
if(gpgme_initialized){
1921
gpgme_release(mc.ctx);
1924
/* Cleans up the circular linked list of Mandos servers the client
1926
if(mc.current_server != NULL){
1927
mc.current_server->prev->next = NULL;
1928
while(mc.current_server != NULL){
1929
server *next = mc.current_server->next;
1930
free(mc.current_server);
1931
mc.current_server = next;
1935
/* Take down the network interface */
1936
if(take_down_interface){
1937
/* Re-raise priviliges */
1941
perror_plus("seteuid");
1944
ret = ioctl(sd, SIOCGIFFLAGS, &network);
1946
perror_plus("ioctl SIOCGIFFLAGS");
1947
} else if(network.ifr_flags & IFF_UP) {
1948
network.ifr_flags &= ~(short)IFF_UP; /* clear flag */
1949
ret = ioctl(sd, SIOCSIFFLAGS, &network);
1951
perror_plus("ioctl SIOCSIFFLAGS -IFF_UP");
1954
ret = (int)TEMP_FAILURE_RETRY(close(sd));
1956
perror_plus("close");
1958
/* Lower privileges permanently */
1962
perror_plus("setuid");
1967
/* Removes the GPGME temp directory and all files inside */
1968
if(tempdir_created){
1969
struct dirent **direntries = NULL;
1970
struct dirent *direntry = NULL;
1971
int numentries = scandir(tempdir, &direntries, notdotentries,
1973
if (numentries > 0){
1974
for(int i = 0; i < numentries; i++){
1975
direntry = direntries[i];
1976
char *fullname = NULL;
1977
ret = asprintf(&fullname, "%s/%s", tempdir,
1980
perror_plus("asprintf");
1983
ret = remove(fullname);
1985
fprintf(stderr, "remove(\"%s\"): %s\n", fullname,
1992
/* need to clean even if 0 because man page doesn't specify */
1994
if (numentries == -1){
1995
perror_plus("scandir");
1997
ret = rmdir(tempdir);
1998
if(ret == -1 and errno != ENOENT){
1999
perror_plus("rmdir");
2004
sigemptyset(&old_sigterm_action.sa_mask);
2005
old_sigterm_action.sa_handler = SIG_DFL;
2006
ret = (int)TEMP_FAILURE_RETRY(sigaction(signal_received,
2007
&old_sigterm_action,
2010
perror_plus("sigaction");
2013
ret = raise(signal_received);
2014
} while(ret != 0 and errno == EINTR);
2016
perror_plus("raise");
2019
TEMP_FAILURE_RETRY(pause());