(root)/mandos/release
» Revision
237.2.64
(compared to revision 237.12.2)
: plugins.d/mandos-client.c
To get this branch, use:
bzr branch
http://bzr.recompile.se/loggerhead/mandos/release
« back to all changes in this revision
Viewing changes to plugins.d/mandos-client.c
- browse files at revision 237.2.64
- compare with another revision
- download diff
- download tarball
- view history from revision 237.2.64
- Committer: Teddy Hogeborn
- Date: 2009-02-07 03:38:17 UTC
- mto: (24.1.133 mandos) (237.4.2 mandos-pipe-ipc) (299.1.1 release) (300.1.1 release) (301.1.1 release)
- mto: This revision was merged to the branch mainline in revision 250.
- Revision ID: teddy@fukt.bsnet.se-20090207033817-aotdjeibhz3sa4lr
* plugin-runner.c (main): If debugging, print name of failed plugins.
- files removed:
- DBUS-API
- debian/source
- files modified:
- .bzrignore
added
removed
plugins.d/mandos-client.c
9
9
* "browse_callback", and parts of "main".
10
10
*
11
11
* Everything else is
12
* Copyright © 2008-2011 Teddy Hogeborn
13
* Copyright © 2008-2011 Björn Påhlsson
12
* Copyright © 2008,2009 Teddy Hogeborn
13
* Copyright © 2008,2009 Björn Påhlsson
14
14
*
15
15
* This program is free software: you can redistribute it and/or
16
16
* modify it under the terms of the GNU General Public License as
26
26
* along with this program. If not, see
27
27
* <http://www.gnu.org/licenses/>.
28
28
*
29
* Contact the authors at <mandos@recompile.se>.
29
* Contact the authors at <mandos@fukt.bsnet.se>.
30
30
*/
31
31
32
32
/* Needed by GPGME, specifically gpgme_data_seek() */
33
#ifndef _LARGEFILE_SOURCE
34
33
#define _LARGEFILE_SOURCE
35
#endif
36
#ifndef _FILE_OFFSET_BITS
37
34
#define _FILE_OFFSET_BITS 64
38
#endif
39
35
40
36
#define _GNU_SOURCE /* TEMP_FAILURE_RETRY(), asprintf() */
41
37
42
38
#include <stdio.h> /* fprintf(), stderr, fwrite(),
43
stdout, ferror(), remove() */
39
stdout, ferror(), sscanf(),
40
remove() */
44
41
#include <stdint.h> /* uint16_t, uint32_t */
45
42
#include <stddef.h> /* NULL, size_t, ssize_t */
46
#include <stdlib.h> /* free(), EXIT_SUCCESS, srand(),
47
strtof(), abort() */
48
#include <stdbool.h> /* bool, false, true */
43
#include <stdlib.h> /* free(), EXIT_SUCCESS, EXIT_FAILURE,
44
srand() */
45
#include <stdbool.h> /* bool, true */
49
46
#include <string.h> /* memset(), strcmp(), strlen(),
50
47
strerror(), asprintf(), strcpy() */
51
#include <sys/ioctl.h> /* ioctl */
48
#include <sys/ioctl.h> /* ioctl */
52
49
#include <sys/types.h> /* socket(), inet_pton(), sockaddr,
53
50
sockaddr_in6, PF_INET6,
54
SOCK_STREAM, uid_t, gid_t, open(),
55
opendir(), DIR */
51
SOCK_STREAM, INET6_ADDRSTRLEN,
52
uid_t, gid_t, open(), opendir(),
53
DIR */
56
54
#include <sys/stat.h> /* open() */
57
55
#include <sys/socket.h> /* socket(), struct sockaddr_in6,
58
inet_pton(), connect() */
56
struct in6_addr, inet_pton(),
57
connect() */
59
58
#include <fcntl.h> /* open() */
60
59
#include <dirent.h> /* opendir(), struct dirent, readdir()
61
60
*/
62
#include <inttypes.h> /* PRIu16, PRIdMAX, intmax_t,
63
strtoimax() */
61
#include <inttypes.h> /* PRIu16, intmax_t, SCNdMAX */
64
62
#include <assert.h> /* assert() */
65
#include <errno.h> /* perror(), errno,
66
program_invocation_short_name */
67
#include <time.h> /* nanosleep(), time(), sleep() */
63
#include <errno.h> /* perror(), errno */
64
#include <time.h> /* nanosleep(), time() */
68
65
#include <net/if.h> /* ioctl, ifreq, SIOCGIFFLAGS, IFF_UP,
69
66
SIOCSIFFLAGS, if_indextoname(),
70
67
if_nametoindex(), IF_NAMESIZE */
71
#include <netinet/in.h> /* IN6_IS_ADDR_LINKLOCAL,
72
INET_ADDRSTRLEN, INET6_ADDRSTRLEN
73
*/
68
#include <netinet/in.h>
74
69
#include <unistd.h> /* close(), SEEK_SET, off_t, write(),
75
getuid(), getgid(), seteuid(),
76
setgid(), pause() */
77
#include <arpa/inet.h> /* inet_pton(), htons, inet_ntop() */
78
#include <iso646.h> /* not, or, and */
70
getuid(), getgid(), setuid(),
71
setgid() */
72
#include <arpa/inet.h> /* inet_pton(), htons */
73
#include <iso646.h> /* not, and, or */
79
74
#include <argp.h> /* struct argp_option, error_t, struct
80
75
argp_state, struct argp,
81
76
argp_parse(), ARGP_KEY_ARG,
82
77
ARGP_KEY_END, ARGP_ERR_UNKNOWN */
83
#include <signal.h> /* sigemptyset(), sigaddset(),
84
sigaction(), SIGTERM, sig_atomic_t,
85
raise() */
86
#include <sysexits.h> /* EX_OSERR, EX_USAGE, EX_UNAVAILABLE,
87
EX_NOHOST, EX_IOERR, EX_PROTOCOL */
88
89
78
#ifdef __linux__
90
79
#include <sys/klog.h> /* klogctl() */
91
#endif /* __linux__ */
80
#endif
92
81
93
82
/* Avahi */
94
83
/* All Avahi types, constants and functions
127
116
bool debug = false;
128
117
static const char mandos_protocol_version[] = "1";
129
118
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;
133
134
/* Doubly linked list that need to be circularly linked when used */
135
typedef struct server{
136
const char *ip;
137
uint16_t port;
138
AvahiIfIndex if_index;
139
int af;
140
struct timespec last_seen;
141
struct server *next;
142
struct server *prev;
143
} server;
119
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
144
120
145
121
/* Used for passing in values through the Avahi callback functions */
146
122
typedef struct {
151
127
gnutls_dh_params_t dh_params;
152
128
const char *priority;
153
129
gpgme_ctx_t ctx;
154
server *current_server;
155
130
} mandos_context;
156
131
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 };
162
163
sig_atomic_t quit_now = 0;
164
int signal_received = 0;
165
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);
170
perror(print_text);
171
}
172
173
132
/*
174
* Make additional room in "buffer" for at least BUFFER_SIZE more
175
* bytes. "buffer_capacity" is how much is currently allocated,
133
* Make room in "buffer" for at least BUFFER_SIZE additional bytes.
134
* "buffer_capacity" is how much is currently allocated,
176
135
* "buffer_length" is how much is already used.
177
136
*/
178
size_t incbuffer(char **buffer, size_t buffer_length,
137
size_t adjustbuffer(char **buffer, size_t buffer_length,
179
138
size_t buffer_capacity){
180
139
if(buffer_length + BUFFER_SIZE > buffer_capacity){
181
140
*buffer = realloc(*buffer, buffer_capacity + BUFFER_SIZE);
187
146
return buffer_capacity;
188
147
}
189
148
190
/* Add server to set of servers to retry periodically */
191
int add_server(const char *ip, uint16_t port,
192
AvahiIfIndex if_index,
193
int af){
194
int ret;
195
server *new_server = malloc(sizeof(server));
196
if(new_server == NULL){
197
perror_plus("malloc");
198
return -1;
199
}
200
*new_server = (server){ .ip = strdup(ip),
201
.port = port,
202
.if_index = if_index,
203
.af = af };
204
if(new_server->ip == NULL){
205
perror_plus("strdup");
206
return -1;
207
}
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 */
214
} else {
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;
219
}
220
ret = clock_gettime(CLOCK_MONOTONIC, &mc.current_server->last_seen);
221
if(ret == -1){
222
perror_plus("clock_gettime");
223
return -1;
224
}
225
return 0;
226
}
227
228
149
/*
229
150
* Initialize GPGME.
230
151
*/
231
static bool init_gpgme(const char *seckey,
152
static bool init_gpgme(mandos_context *mc, const char *seckey,
232
153
const char *pubkey, const char *tempdir){
154
int ret;
233
155
gpgme_error_t rc;
234
156
gpgme_engine_info_t engine_info;
235
157
238
160
* Helper function to insert pub and seckey to the engine keyring.
239
161
*/
240
162
bool import_key(const char *filename){
241
int ret;
242
163
int fd;
243
164
gpgme_data_t pgp_data;
244
165
245
166
fd = (int)TEMP_FAILURE_RETRY(open(filename, O_RDONLY));
246
167
if(fd == -1){
247
perror_plus("open");
168
perror("open");
248
169
return false;
249
170
}
250
171
255
176
return false;
256
177
}
257
178
258
rc = gpgme_op_import(mc.ctx, pgp_data);
179
rc = gpgme_op_import(mc->ctx, pgp_data);
259
180
if(rc != GPG_ERR_NO_ERROR){
260
181
fprintf(stderr, "bad gpgme_op_import: %s: %s\n",
261
182
gpgme_strsource(rc), gpgme_strerror(rc));
264
185
265
186
ret = (int)TEMP_FAILURE_RETRY(close(fd));
266
187
if(ret == -1){
267
perror_plus("close");
188
perror("close");
268
189
}
269
190
gpgme_data_release(pgp_data);
270
191
return true;
271
192
}
272
193
273
194
if(debug){
274
fprintf(stderr, "Initializing GPGME\n");
195
fprintf(stderr, "Initialize gpgme\n");
275
196
}
276
197
277
198
/* Init GPGME */
283
204
return false;
284
205
}
285
206
286
/* Set GPGME home directory for the OpenPGP engine only */
207
/* Set GPGME home directory for the OpenPGP engine only */
287
208
rc = gpgme_get_engine_info(&engine_info);
288
209
if(rc != GPG_ERR_NO_ERROR){
289
210
fprintf(stderr, "bad gpgme_get_engine_info: %s: %s\n",
304
225
}
305
226
306
227
/* Create new GPGME "context" */
307
rc = gpgme_new(&(mc.ctx));
228
rc = gpgme_new(&(mc->ctx));
308
229
if(rc != GPG_ERR_NO_ERROR){
309
230
fprintf(stderr, "bad gpgme_new: %s: %s\n",
310
231
gpgme_strsource(rc), gpgme_strerror(rc));
315
236
return false;
316
237
}
317
238
318
return true;
239
return true;
319
240
}
320
241
321
242
/*
322
243
* Decrypt OpenPGP data.
323
244
* Returns -1 on error
324
245
*/
325
static ssize_t pgp_packet_decrypt(const char *cryptotext,
246
static ssize_t pgp_packet_decrypt(const mandos_context *mc,
247
const char *cryptotext,
326
248
size_t crypto_size,
327
249
char **plaintext){
328
250
gpgme_data_t dh_crypto, dh_plain;
355
277
356
278
/* Decrypt data from the cryptotext data buffer to the plaintext
357
279
data buffer */
358
rc = gpgme_op_decrypt(mc.ctx, dh_crypto, dh_plain);
280
rc = gpgme_op_decrypt(mc->ctx, dh_crypto, dh_plain);
359
281
if(rc != GPG_ERR_NO_ERROR){
360
282
fprintf(stderr, "bad gpgme_op_decrypt: %s: %s\n",
361
283
gpgme_strsource(rc), gpgme_strerror(rc));
362
284
plaintext_length = -1;
363
285
if(debug){
364
286
gpgme_decrypt_result_t result;
365
result = gpgme_op_decrypt_result(mc.ctx);
287
result = gpgme_op_decrypt_result(mc->ctx);
366
288
if(result == NULL){
367
289
fprintf(stderr, "gpgme_op_decrypt_result failed\n");
368
290
} else {
375
297
}
376
298
gpgme_recipient_t recipient;
377
299
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
384
? "No" : "Yes");
385
recipient = recipient->next;
300
if(recipient){
301
while(recipient != NULL){
302
fprintf(stderr, "Public key algorithm: %s\n",
303
gpgme_pubkey_algo_name(recipient->pubkey_algo));
304
fprintf(stderr, "Key ID: %s\n", recipient->keyid);
305
fprintf(stderr, "Secret key available: %s\n",
306
recipient->status == GPG_ERR_NO_SECKEY
307
? "No" : "Yes");
308
recipient = recipient->next;
309
}
386
310
}
387
311
}
388
312
}
395
319
396
320
/* Seek back to the beginning of the GPGME plaintext data buffer */
397
321
if(gpgme_data_seek(dh_plain, (off_t)0, SEEK_SET) == -1){
398
perror_plus("gpgme_data_seek");
322
perror("gpgme_data_seek");
399
323
plaintext_length = -1;
400
324
goto decrypt_end;
401
325
}
402
326
403
327
*plaintext = NULL;
404
328
while(true){
405
plaintext_capacity = incbuffer(plaintext,
329
plaintext_capacity = adjustbuffer(plaintext,
406
330
(size_t)plaintext_length,
407
331
plaintext_capacity);
408
332
if(plaintext_capacity == 0){
409
perror_plus("incbuffer");
333
perror("adjustbuffer");
410
334
plaintext_length = -1;
411
335
goto decrypt_end;
412
336
}
419
343
break;
420
344
}
421
345
if(ret < 0){
422
perror_plus("gpgme_data_read");
346
perror("gpgme_data_read");
423
347
plaintext_length = -1;
424
348
goto decrypt_end;
425
349
}
458
382
fprintf(stderr, "GnuTLS: %s", string);
459
383
}
460
384
461
static int init_gnutls_global(const char *pubkeyfilename,
385
static int init_gnutls_global(mandos_context *mc,
386
const char *pubkeyfilename,
462
387
const char *seckeyfilename){
463
388
int ret;
464
389
482
407
}
483
408
484
409
/* OpenPGP credentials */
485
ret = gnutls_certificate_allocate_credentials(&mc.cred);
410
gnutls_certificate_allocate_credentials(&mc->cred);
486
411
if(ret != GNUTLS_E_SUCCESS){
487
fprintf(stderr, "GnuTLS memory error: %s\n",
412
fprintf(stderr, "GnuTLS memory error: %s\n", /* Spurious warning
413
* from
414
* -Wunreachable-code
415
*/
488
416
safer_gnutls_strerror(ret));
489
417
gnutls_global_deinit();
490
418
return -1;
497
425
}
498
426
499
427
ret = gnutls_certificate_set_openpgp_key_file
500
(mc.cred, pubkeyfilename, seckeyfilename,
428
(mc->cred, pubkeyfilename, seckeyfilename,
501
429
GNUTLS_OPENPGP_FMT_BASE64);
502
430
if(ret != GNUTLS_E_SUCCESS){
503
431
fprintf(stderr,
509
437
}
510
438
511
439
/* GnuTLS server initialization */
512
ret = gnutls_dh_params_init(&mc.dh_params);
440
ret = gnutls_dh_params_init(&mc->dh_params);
513
441
if(ret != GNUTLS_E_SUCCESS){
514
442
fprintf(stderr, "Error in GnuTLS DH parameter initialization:"
515
443
" %s\n", safer_gnutls_strerror(ret));
516
444
goto globalfail;
517
445
}
518
ret = gnutls_dh_params_generate2(mc.dh_params, mc.dh_bits);
446
ret = gnutls_dh_params_generate2(mc->dh_params, mc->dh_bits);
519
447
if(ret != GNUTLS_E_SUCCESS){
520
448
fprintf(stderr, "Error in GnuTLS prime generation: %s\n",
521
449
safer_gnutls_strerror(ret));
522
450
goto globalfail;
523
451
}
524
452
525
gnutls_certificate_set_dh_params(mc.cred, mc.dh_params);
453
gnutls_certificate_set_dh_params(mc->cred, mc->dh_params);
526
454
527
455
return 0;
528
456
529
457
globalfail:
530
458
531
gnutls_certificate_free_credentials(mc.cred);
459
gnutls_certificate_free_credentials(mc->cred);
532
460
gnutls_global_deinit();
533
gnutls_dh_params_deinit(mc.dh_params);
461
gnutls_dh_params_deinit(mc->dh_params);
534
462
return -1;
535
463
}
536
464
537
static int init_gnutls_session(gnutls_session_t *session){
465
static int init_gnutls_session(mandos_context *mc,
466
gnutls_session_t *session){
538
467
int ret;
539
468
/* GnuTLS session creation */
540
do {
541
ret = gnutls_init(session, GNUTLS_SERVER);
542
if(quit_now){
543
return -1;
544
}
545
} while(ret == GNUTLS_E_INTERRUPTED or ret == GNUTLS_E_AGAIN);
469
ret = gnutls_init(session, GNUTLS_SERVER);
546
470
if(ret != GNUTLS_E_SUCCESS){
547
471
fprintf(stderr, "Error in GnuTLS session initialization: %s\n",
548
472
safer_gnutls_strerror(ret));
550
474
551
475
{
552
476
const char *err;
553
do {
554
ret = gnutls_priority_set_direct(*session, mc.priority, &err);
555
if(quit_now){
556
gnutls_deinit(*session);
557
return -1;
558
}
559
} while(ret == GNUTLS_E_INTERRUPTED or ret == GNUTLS_E_AGAIN);
477
ret = gnutls_priority_set_direct(*session, mc->priority, &err);
560
478
if(ret != GNUTLS_E_SUCCESS){
561
479
fprintf(stderr, "Syntax error at: %s\n", err);
562
480
fprintf(stderr, "GnuTLS error: %s\n",
566
484
}
567
485
}
568
486
569
do {
570
ret = gnutls_credentials_set(*session, GNUTLS_CRD_CERTIFICATE,
571
mc.cred);
572
if(quit_now){
573
gnutls_deinit(*session);
574
return -1;
575
}
576
} while(ret == GNUTLS_E_INTERRUPTED or ret == GNUTLS_E_AGAIN);
487
ret = gnutls_credentials_set(*session, GNUTLS_CRD_CERTIFICATE,
488
mc->cred);
577
489
if(ret != GNUTLS_E_SUCCESS){
578
490
fprintf(stderr, "Error setting GnuTLS credentials: %s\n",
579
491
safer_gnutls_strerror(ret));
582
494
}
583
495
584
496
/* ignore client certificate if any. */
585
gnutls_certificate_server_set_request(*session, GNUTLS_CERT_IGNORE);
497
gnutls_certificate_server_set_request(*session,
498
GNUTLS_CERT_IGNORE);
586
499
587
gnutls_dh_set_prime_bits(*session, mc.dh_bits);
500
gnutls_dh_set_prime_bits(*session, mc->dh_bits);
588
501
589
502
return 0;
590
503
}
596
509
/* Called when a Mandos server is found */
597
510
static int start_mandos_communication(const char *ip, uint16_t port,
598
511
AvahiIfIndex if_index,
599
int af){
600
int ret, tcp_sd = -1;
512
mandos_context *mc){
513
int ret, tcp_sd;
601
514
ssize_t sret;
602
union {
603
struct sockaddr_in in;
604
struct sockaddr_in6 in6;
605
} to;
515
union { struct sockaddr in; struct sockaddr_in6 in6; } to;
606
516
char *buffer = NULL;
607
char *decrypted_buffer = NULL;
517
char *decrypted_buffer;
608
518
size_t buffer_length = 0;
609
519
size_t buffer_capacity = 0;
520
ssize_t decrypted_buffer_size;
610
521
size_t written;
611
int retval = -1;
522
int retval = 0;
523
char interface[IF_NAMESIZE];
612
524
gnutls_session_t session;
613
int pf; /* Protocol family */
614
615
errno = 0;
616
617
if(quit_now){
618
errno = EINTR;
619
return -1;
620
}
621
622
switch(af){
623
case AF_INET6:
624
pf = PF_INET6;
625
break;
626
case AF_INET:
627
pf = PF_INET;
628
break;
629
default:
630
fprintf(stderr, "Bad address family: %d\n", af);
631
errno = EINVAL;
632
return -1;
633
}
634
635
ret = init_gnutls_session(&session);
525
526
ret = init_gnutls_session(mc, &session);
636
527
if(ret != 0){
637
528
return -1;
638
529
}
639
530
640
531
if(debug){
641
fprintf(stderr, "Setting up a TCP connection to %s, port %" PRIu16
532
fprintf(stderr, "Setting up a tcp connection to %s, port %" PRIu16
642
533
"\n", ip, port);
643
534
}
644
535
645
tcp_sd = socket(pf, SOCK_STREAM, 0);
536
tcp_sd = socket(PF_INET6, SOCK_STREAM, 0);
646
537
if(tcp_sd < 0){
647
int e = errno;
648
perror_plus("socket");
649
errno = e;
650
goto mandos_end;
538
perror("socket");
539
return -1;
651
540
}
652
541
653
if(quit_now){
654
errno = EINTR;
655
goto mandos_end;
542
if(debug){
543
if(if_indextoname((unsigned int)if_index, interface) == NULL){
544
perror("if_indextoname");
545
return -1;
546
}
547
fprintf(stderr, "Binding to interface %s\n", interface);
656
548
}
657
549
658
550
memset(&to, 0, sizeof(to));
659
if(af == AF_INET6){
660
to.in6.sin6_family = (sa_family_t)af;
661
ret = inet_pton(af, ip, &to.in6.sin6_addr);
662
} else { /* IPv4 */
663
to.in.sin_family = (sa_family_t)af;
664
ret = inet_pton(af, ip, &to.in.sin_addr);
665
}
551
to.in6.sin6_family = AF_INET6;
552
/* It would be nice to have a way to detect if we were passed an
553
IPv4 address here. Now we assume an IPv6 address. */
554
ret = inet_pton(AF_INET6, ip, &to.in6.sin6_addr);
666
555
if(ret < 0 ){
667
int e = errno;
668
perror_plus("inet_pton");
669
errno = e;
670
goto mandos_end;
556
perror("inet_pton");
557
return -1;
671
558
}
672
559
if(ret == 0){
673
int e = errno;
674
560
fprintf(stderr, "Bad address: %s\n", ip);
675
errno = e;
676
goto mandos_end;
561
return -1;
677
562
}
678
if(af == AF_INET6){
679
to.in6.sin6_port = htons(port); /* Spurious warnings from
680
-Wconversion and
681
-Wunreachable-code */
682
683
if(IN6_IS_ADDR_LINKLOCAL /* Spurious warnings from */
684
(&to.in6.sin6_addr)){ /* -Wstrict-aliasing=2 or lower and
685
-Wunreachable-code*/
686
if(if_index == AVAHI_IF_UNSPEC){
687
fprintf(stderr, "An IPv6 link-local address is incomplete"
688
" without a network interface\n");
689
errno = EINVAL;
690
goto mandos_end;
691
}
692
/* Set the network interface number as scope */
693
to.in6.sin6_scope_id = (uint32_t)if_index;
694
}
695
} else {
696
to.in.sin_port = htons(port); /* Spurious warnings from
563
to.in6.sin6_port = htons(port); /* Spurious warnings from
697
564
-Wconversion and
698
565
-Wunreachable-code */
699
}
700
566
701
if(quit_now){
702
errno = EINTR;
703
goto mandos_end;
704
}
567
to.in6.sin6_scope_id = (uint32_t)if_index;
705
568
706
569
if(debug){
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");
711
} else {
712
fprintf(stderr, "Connection to: %s%%%s, port %" PRIu16 "\n",
713
ip, interface, port);
714
}
715
} else {
716
fprintf(stderr, "Connection to: %s, port %" PRIu16 "\n", ip,
717
port);
718
}
719
char addrstr[(INET_ADDRSTRLEN > INET6_ADDRSTRLEN) ?
720
INET_ADDRSTRLEN : INET6_ADDRSTRLEN] = "";
721
const char *pcret;
722
if(af == AF_INET6){
723
pcret = inet_ntop(af, &(to.in6.sin6_addr), addrstr,
724
sizeof(addrstr));
725
} else {
726
pcret = inet_ntop(af, &(to.in.sin_addr), addrstr,
727
sizeof(addrstr));
728
}
729
if(pcret == NULL){
730
perror_plus("inet_ntop");
570
fprintf(stderr, "Connection to: %s, port %" PRIu16 "\n", ip,
571
port);
572
char addrstr[INET6_ADDRSTRLEN] = "";
573
if(inet_ntop(to.in6.sin6_family, &(to.in6.sin6_addr), addrstr,
574
sizeof(addrstr)) == NULL){
575
perror("inet_ntop");
731
576
} else {
732
577
if(strcmp(addrstr, ip) != 0){
733
578
fprintf(stderr, "Canonical address form: %s\n", addrstr);
735
580
}
736
581
}
737
582
738
if(quit_now){
739
errno = EINTR;
740
goto mandos_end;
741
}
742
743
if(af == AF_INET6){
744
ret = connect(tcp_sd, &to.in6, sizeof(to));
745
} else {
746
ret = connect(tcp_sd, &to.in, sizeof(to)); /* IPv4 */
747
}
583
ret = connect(tcp_sd, &to.in, sizeof(to));
748
584
if(ret < 0){
749
if ((errno != ECONNREFUSED and errno != ENETUNREACH) or debug){
750
int e = errno;
751
perror_plus("connect");
752
errno = e;
753
}
754
goto mandos_end;
755
}
756
757
if(quit_now){
758
errno = EINTR;
759
goto mandos_end;
585
perror("connect");
586
return -1;
760
587
}
761
588
762
589
const char *out = mandos_protocol_version;
766
593
ret = (int)TEMP_FAILURE_RETRY(write(tcp_sd, out + written,
767
594
out_size - written));
768
595
if(ret == -1){
769
int e = errno;
770
perror_plus("write");
771
errno = e;
596
perror("write");
597
retval = -1;
772
598
goto mandos_end;
773
599
}
774
600
written += (size_t)ret;
782
608
break;
783
609
}
784
610
}
785
786
if(quit_now){
787
errno = EINTR;
788
goto mandos_end;
789
}
790
611
}
791
612
792
613
if(debug){
793
614
fprintf(stderr, "Establishing TLS session with %s\n", ip);
794
615
}
795
616
796
if(quit_now){
797
errno = EINTR;
798
goto mandos_end;
799
}
800
801
/* Spurious warning from -Wint-to-pointer-cast */
802
617
gnutls_transport_set_ptr(session, (gnutls_transport_ptr_t) tcp_sd);
803
618
804
if(quit_now){
805
errno = EINTR;
806
goto mandos_end;
807
}
808
809
do {
619
do{
810
620
ret = gnutls_handshake(session);
811
if(quit_now){
812
errno = EINTR;
813
goto mandos_end;
814
}
815
621
} while(ret == GNUTLS_E_AGAIN or ret == GNUTLS_E_INTERRUPTED);
816
622
817
623
if(ret != GNUTLS_E_SUCCESS){
819
625
fprintf(stderr, "*** GnuTLS Handshake failed ***\n");
820
626
gnutls_perror(ret);
821
627
}
822
errno = EPROTO;
628
retval = -1;
823
629
goto mandos_end;
824
630
}
825
631
826
632
/* Read OpenPGP packet that contains the wanted password */
827
633
828
634
if(debug){
829
fprintf(stderr, "Retrieving OpenPGP encrypted password from %s\n",
635
fprintf(stderr, "Retrieving pgp encrypted password from %s\n",
830
636
ip);
831
637
}
832
638
833
639
while(true){
834
835
if(quit_now){
836
errno = EINTR;
837
goto mandos_end;
838
}
839
840
buffer_capacity = incbuffer(&buffer, buffer_length,
640
buffer_capacity = adjustbuffer(&buffer, buffer_length,
841
641
buffer_capacity);
842
642
if(buffer_capacity == 0){
843
int e = errno;
844
perror_plus("incbuffer");
845
errno = e;
846
goto mandos_end;
847
}
848
849
if(quit_now){
850
errno = EINTR;
643
perror("adjustbuffer");
644
retval = -1;
851
645
goto mandos_end;
852
646
}
853
647
862
656
case GNUTLS_E_AGAIN:
863
657
break;
864
658
case GNUTLS_E_REHANDSHAKE:
865
do {
659
do{
866
660
ret = gnutls_handshake(session);
867
868
if(quit_now){
869
errno = EINTR;
870
goto mandos_end;
871
}
872
661
} while(ret == GNUTLS_E_AGAIN or ret == GNUTLS_E_INTERRUPTED);
873
662
if(ret < 0){
874
663
fprintf(stderr, "*** GnuTLS Re-handshake failed ***\n");
875
664
gnutls_perror(ret);
876
errno = EPROTO;
665
retval = -1;
877
666
goto mandos_end;
878
667
}
879
668
break;
880
669
default:
881
670
fprintf(stderr, "Unknown error while reading data from"
882
671
" encrypted session with Mandos server\n");
672
retval = -1;
883
673
gnutls_bye(session, GNUTLS_SHUT_RDWR);
884
errno = EIO;
885
674
goto mandos_end;
886
675
}
887
676
} else {
893
682
fprintf(stderr, "Closing TLS session\n");
894
683
}
895
684
896
if(quit_now){
897
errno = EINTR;
898
goto mandos_end;
899
}
900
901
do {
902
ret = gnutls_bye(session, GNUTLS_SHUT_RDWR);
903
if(quit_now){
904
errno = EINTR;
905
goto mandos_end;
906
}
907
} while(ret == GNUTLS_E_AGAIN or ret == GNUTLS_E_INTERRUPTED);
685
gnutls_bye(session, GNUTLS_SHUT_RDWR);
908
686
909
687
if(buffer_length > 0){
910
ssize_t decrypted_buffer_size;
911
decrypted_buffer_size = pgp_packet_decrypt(buffer,
688
decrypted_buffer_size = pgp_packet_decrypt(mc, buffer,
912
689
buffer_length,
913
690
&decrypted_buffer);
914
691
if(decrypted_buffer_size >= 0){
915
916
692
written = 0;
917
693
while(written < (size_t) decrypted_buffer_size){
918
if(quit_now){
919
errno = EINTR;
920
goto mandos_end;
921
}
922
923
694
ret = (int)fwrite(decrypted_buffer + written, 1,
924
695
(size_t)decrypted_buffer_size - written,
925
696
stdout);
926
697
if(ret == 0 and ferror(stdout)){
927
int e = errno;
928
698
if(debug){
929
699
fprintf(stderr, "Error writing encrypted data: %s\n",
930
700
strerror(errno));
931
701
}
932
errno = e;
933
goto mandos_end;
702
retval = -1;
703
break;
934
704
}
935
705
written += (size_t)ret;
936
706
}
937
retval = 0;
707
free(decrypted_buffer);
708
} else {
709
retval = -1;
938
710
}
711
} else {
712
retval = -1;
939
713
}
940
714
941
715
/* Shutdown procedure */
942
716
943
717
mandos_end:
944
{
945
int e = errno;
946
free(decrypted_buffer);
947
free(buffer);
948
if(tcp_sd >= 0){
949
ret = (int)TEMP_FAILURE_RETRY(close(tcp_sd));
950
}
951
if(ret == -1){
952
if(e == 0){
953
e = errno;
954
}
955
perror_plus("close");
956
}
957
gnutls_deinit(session);
958
errno = e;
959
if(quit_now){
960
errno = EINTR;
961
retval = -1;
962
}
718
free(buffer);
719
ret = (int)TEMP_FAILURE_RETRY(close(tcp_sd));
720
if(ret == -1){
721
perror("close");
963
722
}
723
gnutls_deinit(session);
964
724
return retval;
965
725
}
966
726
967
727
static void resolve_callback(AvahiSServiceResolver *r,
968
728
AvahiIfIndex interface,
969
AvahiProtocol proto,
729
AVAHI_GCC_UNUSED AvahiProtocol protocol,
970
730
AvahiResolverEvent event,
971
731
const char *name,
972
732
const char *type,
977
737
AVAHI_GCC_UNUSED AvahiStringList *txt,
978
738
AVAHI_GCC_UNUSED AvahiLookupResultFlags
979
739
flags,
980
AVAHI_GCC_UNUSED void* userdata){
740
void* userdata){
741
mandos_context *mc = userdata;
981
742
assert(r);
982
743
983
744
/* Called whenever a service has been resolved successfully or
984
745
timed out */
985
746
986
if(quit_now){
987
return;
988
}
989
990
747
switch(event){
991
748
default:
992
749
case AVAHI_RESOLVER_FAILURE:
993
750
fprintf(stderr, "(Avahi Resolver) Failed to resolve service '%s'"
994
751
" of type '%s' in domain '%s': %s\n", name, type, domain,
995
avahi_strerror(avahi_server_errno(mc.server)));
752
avahi_strerror(avahi_server_errno(mc->server)));
996
753
break;
997
754
998
755
case AVAHI_RESOLVER_FOUND:
1004
761
PRIdMAX ") on port %" PRIu16 "\n", name, host_name,
1005
762
ip, (intmax_t)interface, port);
1006
763
}
1007
int ret = start_mandos_communication(ip, port, interface,
1008
avahi_proto_to_af(proto));
764
int ret = start_mandos_communication(ip, port, interface, mc);
1009
765
if(ret == 0){
1010
avahi_simple_poll_quit(mc.simple_poll);
1011
} else {
1012
ret = add_server(ip, port, interface,
1013
avahi_proto_to_af(proto));
766
avahi_simple_poll_quit(mc->simple_poll);
1014
767
}
1015
768
}
1016
769
}
1026
779
const char *domain,
1027
780
AVAHI_GCC_UNUSED AvahiLookupResultFlags
1028
781
flags,
1029
AVAHI_GCC_UNUSED void* userdata){
782
void* userdata){
783
mandos_context *mc = userdata;
1030
784
assert(b);
1031
785
1032
786
/* Called whenever a new services becomes available on the LAN or
1033
787
is removed from the LAN */
1034
788
1035
if(quit_now){
1036
return;
1037
}
1038
1039
789
switch(event){
1040
790
default:
1041
791
case AVAHI_BROWSER_FAILURE:
1042
792
1043
793
fprintf(stderr, "(Avahi browser) %s\n",
1044
avahi_strerror(avahi_server_errno(mc.server)));
1045
avahi_simple_poll_quit(mc.simple_poll);
794
avahi_strerror(avahi_server_errno(mc->server)));
795
avahi_simple_poll_quit(mc->simple_poll);
1046
796
return;
1047
797
1048
798
case AVAHI_BROWSER_NEW:
1051
801
the callback function is called the Avahi server will free the
1052
802
resolver for us. */
1053
803
1054
if(avahi_s_service_resolver_new(mc.server, interface, protocol,
1055
name, type, domain, protocol, 0,
1056
resolve_callback, NULL) == NULL)
804
if(!(avahi_s_service_resolver_new(mc->server, interface,
805
protocol, name, type, domain,
806
AVAHI_PROTO_INET6, 0,
807
resolve_callback, mc)))
1057
808
fprintf(stderr, "Avahi: Failed to resolve service '%s': %s\n",
1058
name, avahi_strerror(avahi_server_errno(mc.server)));
809
name, avahi_strerror(avahi_server_errno(mc->server)));
1059
810
break;
1060
811
1061
812
case AVAHI_BROWSER_REMOVE:
1070
821
}
1071
822
}
1072
823
1073
/* Signal handler that stops main loop after SIGTERM */
1074
static void handle_sigterm(int sig){
1075
if(quit_now){
1076
return;
1077
}
1078
quit_now = 1;
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);
1084
}
1085
errno = old_errno;
1086
}
1087
1088
/*
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.)
1092
*/
1093
int good_interface(const struct dirent *if_entry){
1094
ssize_t ssret;
1095
char *flagname = NULL;
1096
if(if_entry->d_name[0] == '.'){
1097
return 0;
1098
}
1099
int ret = asprintf(&flagname, "%s/%s/flags", sys_class_net,
1100
if_entry->d_name);
1101
if(ret < 0){
1102
perror_plus("asprintf");
1103
return 0;
1104
}
1105
int flags_fd = (int)TEMP_FAILURE_RETRY(open(flagname, O_RDONLY));
1106
if(flags_fd == -1){
1107
perror_plus("open");
1108
free(flagname);
1109
return 0;
1110
}
1111
free(flagname);
1112
typedef short ifreq_flags; /* ifreq.ifr_flags in netdevice(7) */
1113
/* read line from flags_fd */
1114
ssize_t to_read = 2+(sizeof(ifreq_flags)*2)+1; /* "0x1003\n" */
1115
char *flagstring = malloc((size_t)to_read+1); /* +1 for final \0 */
1116
flagstring[(size_t)to_read] = '\0';
1117
if(flagstring == NULL){
1118
perror_plus("malloc");
1119
close(flags_fd);
1120
return 0;
1121
}
1122
while(to_read > 0){
1123
ssret = (ssize_t)TEMP_FAILURE_RETRY(read(flags_fd, flagstring,
1124
(size_t)to_read));
1125
if(ssret == -1){
1126
perror_plus("read");
1127
free(flagstring);
1128
close(flags_fd);
1129
return 0;
1130
}
1131
to_read -= ssret;
1132
if(ssret == 0){
1133
break;
1134
}
1135
}
1136
close(flags_fd);
1137
intmax_t tmpmax;
1138
char *tmp;
1139
errno = 0;
1140
tmpmax = strtoimax(flagstring, &tmp, 0);
1141
if(errno != 0 or tmp == flagstring or (*tmp != '\0'
1142
and not (isspace(*tmp)))
1143
or tmpmax != (ifreq_flags)tmpmax){
1144
if(debug){
1145
fprintf(stderr, "Invalid flags \"%s\" for interface \"%s\"\n",
1146
flagstring, if_entry->d_name);
1147
}
1148
free(flagstring);
1149
return 0;
1150
}
1151
free(flagstring);
1152
ifreq_flags flags = (ifreq_flags)tmpmax;
1153
/* Reject the loopback device */
1154
if(flags & IFF_LOOPBACK){
1155
if(debug){
1156
fprintf(stderr, "Rejecting loopback interface \"%s\"\n",
1157
if_entry->d_name);
1158
}
1159
return 0;
1160
}
1161
/* Accept point-to-point devices only if connect_to is specified */
1162
if(connect_to != NULL and (flags & IFF_POINTOPOINT)){
1163
if(debug){
1164
fprintf(stderr, "Accepting point-to-point interface \"%s\"\n",
1165
if_entry->d_name);
1166
}
1167
return 1;
1168
}
1169
/* Otherwise, reject non-broadcast-capable devices */
1170
if(not (flags & IFF_BROADCAST)){
1171
if(debug){
1172
fprintf(stderr, "Rejecting non-broadcast interface \"%s\"\n",
1173
if_entry->d_name);
1174
}
1175
return 0;
1176
}
1177
/* Reject non-ARP interfaces (including dummy interfaces) */
1178
if(flags & IFF_NOARP){
1179
if(debug){
1180
fprintf(stderr, "Rejecting non-ARP interface \"%s\"\n",
1181
if_entry->d_name);
1182
}
1183
return 0;
1184
}
1185
/* Accept this device */
1186
if(debug){
1187
fprintf(stderr, "Interface \"%s\" is acceptable\n",
1188
if_entry->d_name);
1189
}
1190
return 1;
1191
}
1192
1193
int notdotentries(const struct dirent *direntry){
1194
/* Skip "." and ".." */
1195
if(direntry->d_name[0] == '.'
1196
and (direntry->d_name[1] == '\0'
1197
or (direntry->d_name[1] == '.'
1198
and direntry->d_name[2] == '\0'))){
1199
return 0;
1200
}
1201
return 1;
1202
}
1203
1204
int avahi_loop_with_timeout(AvahiSimplePoll *s, int retry_interval){
1205
int ret;
1206
struct timespec now;
1207
struct timespec waited_time;
1208
intmax_t block_time;
1209
1210
while(true){
1211
if(mc.current_server == NULL){
1212
if (debug){
1213
fprintf(stderr,
1214
"Wait until first server is found. No timeout!\n");
1215
}
1216
ret = avahi_simple_poll_iterate(s, -1);
1217
} else {
1218
if (debug){
1219
fprintf(stderr, "Check current_server if we should run it,"
1220
" or wait\n");
1221
}
1222
/* the current time */
1223
ret = clock_gettime(CLOCK_MONOTONIC, &now);
1224
if(ret == -1){
1225
perror_plus("clock_gettime");
1226
return -1;
1227
}
1228
/* Calculating in ms how long time between now and server
1229
who we visted longest time ago. Now - last seen. */
1230
waited_time.tv_sec = (now.tv_sec
1231
- mc.current_server->last_seen.tv_sec);
1232
waited_time.tv_nsec = (now.tv_nsec
1233
- mc.current_server->last_seen.tv_nsec);
1234
/* total time is 10s/10,000ms.
1235
Converting to s from ms by dividing by 1,000,
1236
and ns to ms by dividing by 1,000,000. */
1237
block_time = ((retry_interval
1238
- ((intmax_t)waited_time.tv_sec * 1000))
1239
- ((intmax_t)waited_time.tv_nsec / 1000000));
1240
1241
if (debug){
1242
fprintf(stderr, "Blocking for %" PRIdMAX " ms\n", block_time);
1243
}
1244
1245
if(block_time <= 0){
1246
ret = start_mandos_communication(mc.current_server->ip,
1247
mc.current_server->port,
1248
mc.current_server->if_index,
1249
mc.current_server->af);
1250
if(ret == 0){
1251
avahi_simple_poll_quit(mc.simple_poll);
1252
return 0;
1253
}
1254
ret = clock_gettime(CLOCK_MONOTONIC,
1255
&mc.current_server->last_seen);
1256
if(ret == -1){
1257
perror_plus("clock_gettime");
1258
return -1;
1259
}
1260
mc.current_server = mc.current_server->next;
1261
block_time = 0; /* Call avahi to find new Mandos
1262
servers, but don't block */
1263
}
1264
1265
ret = avahi_simple_poll_iterate(s, (int)block_time);
1266
}
1267
if(ret != 0){
1268
if (ret > 0 or errno != EINTR) {
1269
return (ret != 1) ? ret : 0;
1270
}
1271
}
1272
}
1273
}
1274
1275
824
int main(int argc, char *argv[]){
1276
825
AvahiSServiceBrowser *sb = NULL;
1277
826
int error;
1278
827
int ret;
1279
828
intmax_t tmpmax;
1280
char *tmp;
829
int numchars;
1281
830
int exitcode = EXIT_SUCCESS;
1282
const char *interface = "";
831
const char *interface = "eth0";
1283
832
struct ifreq network;
1284
int sd = -1;
1285
bool take_down_interface = false;
833
int sd;
1286
834
uid_t uid;
1287
835
gid_t gid;
836
char *connect_to = NULL;
1288
837
char tempdir[] = "/tmp/mandosXXXXXX";
1289
838
bool tempdir_created = false;
1290
839
AvahiIfIndex if_index = AVAHI_IF_UNSPEC;
1291
840
const char *seckey = PATHDIR "/" SECKEY;
1292
841
const char *pubkey = PATHDIR "/" PUBKEY;
1293
842
843
mandos_context mc = { .simple_poll = NULL, .server = NULL,
844
.dh_bits = 1024, .priority = "SECURE256"
845
":!CTYPE-X.509:+CTYPE-OPENPGP" };
1294
846
bool gnutls_initialized = false;
1295
847
bool gpgme_initialized = false;
1296
float delay = 2.5f;
1297
double retry_interval = 10; /* 10s between trying a server and
1298
retrying the same server again */
1299
1300
struct sigaction old_sigterm_action = { .sa_handler = SIG_DFL };
1301
struct sigaction sigterm_action = { .sa_handler = handle_sigterm };
1302
1303
uid = getuid();
1304
gid = getgid();
1305
1306
/* Lower any group privileges we might have, just to be safe */
1307
errno = 0;
1308
ret = setgid(gid);
1309
if(ret == -1){
1310
perror_plus("setgid");
1311
}
1312
1313
/* Lower user privileges (temporarily) */
1314
errno = 0;
1315
ret = seteuid(uid);
1316
if(ret == -1){
1317
perror_plus("seteuid");
1318
}
1319
1320
if(quit_now){
1321
goto end;
1322
}
848
double delay = 2.5;
1323
849
1324
850
{
1325
851
struct argp_option options[] = {
1331
857
.group = 1 },
1332
858
{ .name = "interface", .key = 'i',
1333
859
.arg = "NAME",
1334
.doc = "Network interface that will be used to search for"
1335
" Mandos servers",
860
.doc = "Interface that will be used to search for Mandos"
861
" servers",
1336
862
.group = 1 },
1337
863
{ .name = "seckey", .key = 's',
1338
864
.arg = "FILE",
1355
881
.arg = "SECONDS",
1356
882
.doc = "Maximum delay to wait for interface startup",
1357
883
.group = 2 },
1358
{ .name = "retry", .key = 132,
1359
.arg = "SECONDS",
1360
.doc = "Retry interval used when denied by the mandos server",
1361
.group = 2 },
1362
/*
1363
* These reproduce what we would get without ARGP_NO_HELP
1364
*/
1365
{ .name = "help", .key = '?',
1366
.doc = "Give this help list", .group = -1 },
1367
{ .name = "usage", .key = -3,
1368
.doc = "Give a short usage message", .group = -1 },
1369
{ .name = "version", .key = 'V',
1370
.doc = "Print program version", .group = -1 },
1371
884
{ .name = NULL }
1372
885
};
1373
886
1374
887
error_t parse_opt(int key, char *arg,
1375
888
struct argp_state *state){
1376
errno = 0;
1377
889
switch(key){
1378
890
case 128: /* --debug */
1379
891
debug = true;
1391
903
pubkey = arg;
1392
904
break;
1393
905
case 129: /* --dh-bits */
1394
errno = 0;
1395
tmpmax = strtoimax(arg, &tmp, 10);
1396
if(errno != 0 or tmp == arg or *tmp != '\0'
1397
or tmpmax != (typeof(mc.dh_bits))tmpmax){
1398
argp_error(state, "Bad number of DH bits");
906
ret = sscanf(arg, "%" SCNdMAX "%n", &tmpmax, &numchars);
907
if(ret < 1 or tmpmax != (typeof(mc.dh_bits))tmpmax
908
or arg[numchars] != '\0'){
909
fprintf(stderr, "Bad number of DH bits\n");
910
exit(EXIT_FAILURE);
1399
911
}
1400
912
mc.dh_bits = (typeof(mc.dh_bits))tmpmax;
1401
913
break;
1403
915
mc.priority = arg;
1404
916
break;
1405
917
case 131: /* --delay */
1406
errno = 0;
1407
delay = strtof(arg, &tmp);
1408
if(errno != 0 or tmp == arg or *tmp != '\0'){
1409
argp_error(state, "Bad delay");
1410
}
1411
case 132: /* --retry */
1412
errno = 0;
1413
retry_interval = strtod(arg, &tmp);
1414
if(errno != 0 or tmp == arg or *tmp != '\0'
1415
or (retry_interval * 1000) > INT_MAX
1416
or retry_interval < 0){
1417
argp_error(state, "Bad retry interval");
918
ret = sscanf(arg, "%lf%n", &delay, &numchars);
919
if(ret < 1 or arg[numchars] != '\0'){
920
fprintf(stderr, "Bad delay\n");
921
exit(EXIT_FAILURE);
1418
922
}
1419
923
break;
1420
/*
1421
* These reproduce what we would get without ARGP_NO_HELP
1422
*/
1423
case '?': /* --help */
1424
argp_state_help(state, state->out_stream,
1425
(ARGP_HELP_STD_HELP | ARGP_HELP_EXIT_ERR)
1426
& ~(unsigned int)ARGP_HELP_EXIT_OK);
1427
case -3: /* --usage */
1428
argp_state_help(state, state->out_stream,
1429
ARGP_HELP_USAGE | ARGP_HELP_EXIT_ERR);
1430
case 'V': /* --version */
1431
fprintf(state->out_stream, "%s\n", argp_program_version);
1432
exit(argp_err_exit_status);
924
case ARGP_KEY_ARG:
925
argp_usage(state);
926
case ARGP_KEY_END:
1433
927
break;
1434
928
default:
1435
929
return ARGP_ERR_UNKNOWN;
1436
930
}
1437
return errno;
931
return 0;
1438
932
}
1439
933
1440
934
struct argp argp = { .options = options, .parser = parse_opt,
1441
935
.args_doc = "",
1442
936
.doc = "Mandos client -- Get and decrypt"
1443
937
" passwords from a Mandos server" };
1444
ret = argp_parse(&argp, argc, argv,
1445
ARGP_IN_ORDER | ARGP_NO_HELP, 0, NULL);
1446
switch(ret){
1447
case 0:
1448
break;
1449
case ENOMEM:
1450
default:
1451
errno = ret;
1452
perror_plus("argp_parse");
1453
exitcode = EX_OSERR;
1454
goto end;
1455
case EINVAL:
1456
exitcode = EX_USAGE;
1457
goto end;
1458
}
1459
}
1460
1461
{
1462
/* Work around Debian bug #633582:
1463
<http://bugs.debian.org/633582> */
1464
struct stat st;
1465
1466
/* Re-raise priviliges */
1467
errno = 0;
1468
ret = seteuid(0);
1469
if(ret == -1){
1470
perror_plus("seteuid");
1471
}
1472
1473
if(strcmp(seckey, PATHDIR "/" SECKEY) == 0){
1474
int seckey_fd = open(seckey, O_RDONLY);
1475
if(seckey_fd == -1){
1476
perror_plus("open");
1477
} else {
1478
ret = (int)TEMP_FAILURE_RETRY(fstat(seckey_fd, &st));
1479
if(ret == -1){
1480
perror_plus("fstat");
1481
} else {
1482
if(S_ISREG(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
1483
ret = fchown(seckey_fd, uid, gid);
1484
if(ret == -1){
1485
perror_plus("fchown");
1486
}
1487
}
1488
}
1489
TEMP_FAILURE_RETRY(close(seckey_fd));
1490
}
1491
}
1492
1493
if(strcmp(pubkey, PATHDIR "/" PUBKEY) == 0){
1494
int pubkey_fd = open(pubkey, O_RDONLY);
1495
if(pubkey_fd == -1){
1496
perror_plus("open");
1497
} else {
1498
ret = (int)TEMP_FAILURE_RETRY(fstat(pubkey_fd, &st));
1499
if(ret == -1){
1500
perror_plus("fstat");
1501
} else {
1502
if(S_ISREG(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
1503
ret = fchown(pubkey_fd, uid, gid);
1504
if(ret == -1){
1505
perror_plus("fchown");
1506
}
1507
}
1508
}
1509
TEMP_FAILURE_RETRY(close(pubkey_fd));
1510
}
1511
}
1512
1513
/* Lower privileges */
1514
errno = 0;
1515
ret = seteuid(uid);
1516
if(ret == -1){
1517
perror_plus("seteuid");
1518
}
1519
}
1520
1521
if(not debug){
1522
avahi_set_log_function(empty_log);
1523
}
1524
1525
if(interface[0] == '\0'){
1526
struct dirent **direntries;
1527
ret = scandir(sys_class_net, &direntries, good_interface,
1528
alphasort);
1529
if(ret >= 1){
1530
/* Pick the first good interface */
1531
interface = strdup(direntries[0]->d_name);
1532
if(debug){
1533
fprintf(stderr, "Using interface \"%s\"\n", interface);
1534
}
1535
if(interface == NULL){
1536
perror_plus("malloc");
1537
free(direntries);
1538
exitcode = EXIT_FAILURE;
1539
goto end;
1540
}
1541
free(direntries);
1542
} else {
1543
free(direntries);
1544
fprintf(stderr, "Could not find a network interface\n");
938
ret = argp_parse(&argp, argc, argv, 0, 0, NULL);
939
if(ret == ARGP_ERR_UNKNOWN){
940
fprintf(stderr, "Unknown error while parsing arguments\n");
1545
941
exitcode = EXIT_FAILURE;
1546
942
goto end;
1547
943
}
1548
944
}
1549
945
1550
/* Initialize Avahi early so avahi_simple_poll_quit() can be called
1551
from the signal handler */
1552
/* Initialize the pseudo-RNG for Avahi */
1553
srand((unsigned int) time(NULL));
1554
mc.simple_poll = avahi_simple_poll_new();
1555
if(mc.simple_poll == NULL){
1556
fprintf(stderr, "Avahi: Failed to create simple poll object.\n");
1557
exitcode = EX_UNAVAILABLE;
1558
goto end;
1559
}
1560
1561
sigemptyset(&sigterm_action.sa_mask);
1562
ret = sigaddset(&sigterm_action.sa_mask, SIGINT);
1563
if(ret == -1){
1564
perror_plus("sigaddset");
1565
exitcode = EX_OSERR;
1566
goto end;
1567
}
1568
ret = sigaddset(&sigterm_action.sa_mask, SIGHUP);
1569
if(ret == -1){
1570
perror_plus("sigaddset");
1571
exitcode = EX_OSERR;
1572
goto end;
1573
}
1574
ret = sigaddset(&sigterm_action.sa_mask, SIGTERM);
1575
if(ret == -1){
1576
perror_plus("sigaddset");
1577
exitcode = EX_OSERR;
1578
goto end;
1579
}
1580
/* Need to check if the handler is SIG_IGN before handling:
1581
| [[info:libc:Initial Signal Actions]] |
1582
| [[info:libc:Basic Signal Handling]] |
1583
*/
1584
ret = sigaction(SIGINT, NULL, &old_sigterm_action);
1585
if(ret == -1){
1586
perror_plus("sigaction");
1587
return EX_OSERR;
1588
}
1589
if(old_sigterm_action.sa_handler != SIG_IGN){
1590
ret = sigaction(SIGINT, &sigterm_action, NULL);
1591
if(ret == -1){
1592
perror_plus("sigaction");
1593
exitcode = EX_OSERR;
1594
goto end;
1595
}
1596
}
1597
ret = sigaction(SIGHUP, NULL, &old_sigterm_action);
1598
if(ret == -1){
1599
perror_plus("sigaction");
1600
return EX_OSERR;
1601
}
1602
if(old_sigterm_action.sa_handler != SIG_IGN){
1603
ret = sigaction(SIGHUP, &sigterm_action, NULL);
1604
if(ret == -1){
1605
perror_plus("sigaction");
1606
exitcode = EX_OSERR;
1607
goto end;
1608
}
1609
}
1610
ret = sigaction(SIGTERM, NULL, &old_sigterm_action);
1611
if(ret == -1){
1612
perror_plus("sigaction");
1613
return EX_OSERR;
1614
}
1615
if(old_sigterm_action.sa_handler != SIG_IGN){
1616
ret = sigaction(SIGTERM, &sigterm_action, NULL);
1617
if(ret == -1){
1618
perror_plus("sigaction");
1619
exitcode = EX_OSERR;
1620
goto end;
1621
}
1622
}
1623
1624
946
/* If the interface is down, bring it up */
1625
if(strcmp(interface, "none") != 0){
1626
if_index = (AvahiIfIndex) if_nametoindex(interface);
1627
if(if_index == 0){
1628
fprintf(stderr, "No such interface: \"%s\"\n", interface);
1629
exitcode = EX_UNAVAILABLE;
1630
goto end;
1631
}
1632
1633
if(quit_now){
1634
goto end;
1635
}
1636
1637
/* Re-raise priviliges */
1638
errno = 0;
1639
ret = seteuid(0);
1640
if(ret == -1){
1641
perror_plus("seteuid");
1642
}
1643
947
{
1644
948
#ifdef __linux__
1645
949
/* Lower kernel loglevel to KERN_NOTICE to avoid KERN_INFO
1646
messages about the network interface to mess up the prompt */
950
messages to mess up the prompt */
1647
951
ret = klogctl(8, NULL, 5);
1648
bool restore_loglevel = true;
1649
952
if(ret == -1){
1650
restore_loglevel = false;
1651
perror_plus("klogctl");
953
perror("klogctl");
1652
954
}
1653
#endif /* __linux__ */
955
#endif
1654
956
1655
957
sd = socket(PF_INET6, SOCK_DGRAM, IPPROTO_IP);
1656
958
if(sd < 0){
1657
perror_plus("socket");
1658
exitcode = EX_OSERR;
959
perror("socket");
960
exitcode = EXIT_FAILURE;
1659
961
#ifdef __linux__
1660
if(restore_loglevel){
1661
ret = klogctl(7, NULL, 0);
1662
if(ret == -1){
1663
perror_plus("klogctl");
1664
}
1665
}
1666
#endif /* __linux__ */
1667
/* Lower privileges */
1668
errno = 0;
1669
ret = seteuid(uid);
962
ret = klogctl(7, NULL, 0);
1670
963
if(ret == -1){
1671
perror_plus("seteuid");
964
perror("klogctl");
1672
965
}
966
#endif
1673
967
goto end;
1674
968
}
1675
969
strcpy(network.ifr_name, interface);
1676
970
ret = ioctl(sd, SIOCGIFFLAGS, &network);
1677
971
if(ret == -1){
1678
perror_plus("ioctl SIOCGIFFLAGS");
972
perror("ioctl SIOCGIFFLAGS");
1679
973
#ifdef __linux__
1680
if(restore_loglevel){
1681
ret = klogctl(7, NULL, 0);
1682
if(ret == -1){
1683
perror_plus("klogctl");
1684
}
1685
}
1686
#endif /* __linux__ */
1687
exitcode = EX_OSERR;
1688
/* Lower privileges */
1689
errno = 0;
1690
ret = seteuid(uid);
974
ret = klogctl(7, NULL, 0);
1691
975
if(ret == -1){
1692
perror_plus("seteuid");
976
perror("klogctl");
1693
977
}
978
#endif
979
exitcode = EXIT_FAILURE;
1694
980
goto end;
1695
981
}
1696
982
if((network.ifr_flags & IFF_UP) == 0){
1697
983
network.ifr_flags |= IFF_UP;
1698
take_down_interface = true;
1699
984
ret = ioctl(sd, SIOCSIFFLAGS, &network);
1700
985
if(ret == -1){
1701
take_down_interface = false;
1702
perror_plus("ioctl SIOCSIFFLAGS +IFF_UP");
1703
exitcode = EX_OSERR;
986
perror("ioctl SIOCSIFFLAGS");
987
exitcode = EXIT_FAILURE;
1704
988
#ifdef __linux__
1705
if(restore_loglevel){
1706
ret = klogctl(7, NULL, 0);
1707
if(ret == -1){
1708
perror_plus("klogctl");
1709
}
1710
}
1711
#endif /* __linux__ */
1712
/* Lower privileges */
1713
errno = 0;
1714
ret = seteuid(uid);
989
ret = klogctl(7, NULL, 0);
1715
990
if(ret == -1){
1716
perror_plus("seteuid");
991
perror("klogctl");
1717
992
}
993
#endif
1718
994
goto end;
1719
995
}
1720
996
}
1721
/* Sleep checking until interface is running.
1722
Check every 0.25s, up to total time of delay */
997
/* sleep checking until interface is running */
1723
998
for(int i=0; i < delay * 4; i++){
1724
999
ret = ioctl(sd, SIOCGIFFLAGS, &network);
1725
1000
if(ret == -1){
1726
perror_plus("ioctl SIOCGIFFLAGS");
1001
perror("ioctl SIOCGIFFLAGS");
1727
1002
} else if(network.ifr_flags & IFF_RUNNING){
1728
1003
break;
1729
1004
}
1730
1005
struct timespec sleeptime = { .tv_nsec = 250000000 };
1731
1006
ret = nanosleep(&sleeptime, NULL);
1732
1007
if(ret == -1 and errno != EINTR){
1733
perror_plus("nanosleep");
1008
perror("nanosleep");
1734
1009
}
1735
1010
}
1736
if(not take_down_interface){
1737
/* We won't need the socket anymore */
1738
ret = (int)TEMP_FAILURE_RETRY(close(sd));
1739
if(ret == -1){
1740
perror_plus("close");
1741
}
1011
ret = (int)TEMP_FAILURE_RETRY(close(sd));
1012
if(ret == -1){
1013
perror("close");
1742
1014
}
1743
1015
#ifdef __linux__
1744
if(restore_loglevel){
1745
/* Restores kernel loglevel to default */
1746
ret = klogctl(7, NULL, 0);
1747
if(ret == -1){
1748
perror_plus("klogctl");
1749
}
1750
}
1751
#endif /* __linux__ */
1752
/* Lower privileges */
1753
errno = 0;
1754
if(take_down_interface){
1755
/* Lower privileges */
1756
ret = seteuid(uid);
1757
if(ret == -1){
1758
perror_plus("seteuid");
1759
}
1760
} else {
1761
/* Lower privileges permanently */
1762
ret = setuid(uid);
1763
if(ret == -1){
1764
perror_plus("setuid");
1765
}
1766
}
1767
}
1768
1769
if(quit_now){
1770
goto end;
1771
}
1772
1773
ret = init_gnutls_global(pubkey, seckey);
1016
/* Restores kernel loglevel to default */
1017
ret = klogctl(7, NULL, 0);
1018
if(ret == -1){
1019
perror("klogctl");
1020
}
1021
#endif
1022
}
1023
1024
uid = getuid();
1025
gid = getgid();
1026
1027
setgid(gid);
1028
if(ret == -1){
1029
perror("setgid");
1030
}
1031
1032
ret = setuid(uid);
1033
if(ret == -1){
1034
perror("setuid");
1035
}
1036
1037
ret = init_gnutls_global(&mc, pubkey, seckey);
1774
1038
if(ret == -1){
1775
1039
fprintf(stderr, "init_gnutls_global failed\n");
1776
exitcode = EX_UNAVAILABLE;
1040
exitcode = EXIT_FAILURE;
1777
1041
goto end;
1778
1042
} else {
1779
1043
gnutls_initialized = true;
1780
1044
}
1781
1045
1782
if(quit_now){
1783
goto end;
1784
}
1785
1786
1046
if(mkdtemp(tempdir) == NULL){
1787
perror_plus("mkdtemp");
1047
perror("mkdtemp");
1788
1048
goto end;
1789
1049
}
1790
1050
tempdir_created = true;
1791
1051
1792
if(quit_now){
1793
goto end;
1794
}
1795
1796
if(not init_gpgme(pubkey, seckey, tempdir)){
1052
if(not init_gpgme(&mc, pubkey, seckey, tempdir)){
1797
1053
fprintf(stderr, "init_gpgme failed\n");
1798
exitcode = EX_UNAVAILABLE;
1054
exitcode = EXIT_FAILURE;
1799
1055
goto end;
1800
1056
} else {
1801
1057
gpgme_initialized = true;
1802
1058
}
1803
1059
1804
if(quit_now){
1060
if_index = (AvahiIfIndex) if_nametoindex(interface);
1061
if(if_index == 0){
1062
fprintf(stderr, "No such interface: \"%s\"\n", interface);
1063
exitcode = EXIT_FAILURE;
1805
1064
goto end;
1806
1065
}
1807
1066
1811
1070
char *address = strrchr(connect_to, ':');
1812
1071
if(address == NULL){
1813
1072
fprintf(stderr, "No colon in address\n");
1814
exitcode = EX_USAGE;
1815
goto end;
1816
}
1817
1818
if(quit_now){
1819
goto end;
1820
}
1821
1073
exitcode = EXIT_FAILURE;
1074
goto end;
1075
}
1822
1076
uint16_t port;
1823
errno = 0;
1824
tmpmax = strtoimax(address+1, &tmp, 10);
1825
if(errno != 0 or tmp == address+1 or *tmp != '\0'
1826
or tmpmax != (uint16_t)tmpmax){
1077
ret = sscanf(address+1, "%" SCNdMAX "%n", &tmpmax, &numchars);
1078
if(ret < 1 or tmpmax != (uint16_t)tmpmax
1079
or address[numchars+1] != '\0'){
1827
1080
fprintf(stderr, "Bad port number\n");
1828
exitcode = EX_USAGE;
1829
goto end;
1830
}
1831
1832
if(quit_now){
1833
goto end;
1834
}
1835
1081
exitcode = EXIT_FAILURE;
1082
goto end;
1083
}
1836
1084
port = (uint16_t)tmpmax;
1837
1085
*address = '\0';
1838
/* Colon in address indicates IPv6 */
1839
int af;
1840
if(strchr(connect_to, ':') != NULL){
1841
af = AF_INET6;
1842
/* Accept [] around IPv6 address - see RFC 5952 */
1843
if(connect_to[0] == '[' and address[-1] == ']')
1844
{
1845
connect_to++;
1846
address[-1] = '\0';
1847
}
1848
} else {
1849
af = AF_INET;
1850
}
1851
1086
address = connect_to;
1852
1853
if(quit_now){
1854
goto end;
1855
}
1856
1857
while(not quit_now){
1858
ret = start_mandos_communication(address, port, if_index, af);
1859
if(quit_now or ret == 0){
1860
break;
1861
}
1862
if(debug){
1863
fprintf(stderr, "Retrying in %d seconds\n",
1864
(int)retry_interval);
1865
}
1866
sleep((int)retry_interval);
1867
}
1868
1869
if (not quit_now){
1087
ret = start_mandos_communication(address, port, if_index, &mc);
1088
if(ret < 0){
1089
exitcode = EXIT_FAILURE;
1090
} else {
1870
1091
exitcode = EXIT_SUCCESS;
1871
1092
}
1872
1873
1093
goto end;
1874
1094
}
1875
1095
1876
if(quit_now){
1096
if(not debug){
1097
avahi_set_log_function(empty_log);
1098
}
1099
1100
/* Initialize the pseudo-RNG for Avahi */
1101
srand((unsigned int) time(NULL));
1102
1103
/* Allocate main Avahi loop object */
1104
mc.simple_poll = avahi_simple_poll_new();
1105
if(mc.simple_poll == NULL){
1106
fprintf(stderr, "Avahi: Failed to create simple poll object.\n");
1107
exitcode = EXIT_FAILURE;
1877
1108
goto end;
1878
1109
}
1879
1110
1899
1130
if(mc.server == NULL){
1900
1131
fprintf(stderr, "Failed to create Avahi server: %s\n",
1901
1132
avahi_strerror(error));
1902
exitcode = EX_UNAVAILABLE;
1903
goto end;
1904
}
1905
1906
if(quit_now){
1133
exitcode = EXIT_FAILURE;
1907
1134
goto end;
1908
1135
}
1909
1136
1910
1137
/* Create the Avahi service browser */
1911
1138
sb = avahi_s_service_browser_new(mc.server, if_index,
1912
AVAHI_PROTO_UNSPEC, "_mandos._tcp",
1913
NULL, 0, browse_callback, NULL);
1139
AVAHI_PROTO_INET6, "_mandos._tcp",
1140
NULL, 0, browse_callback, &mc);
1914
1141
if(sb == NULL){
1915
1142
fprintf(stderr, "Failed to create service browser: %s\n",
1916
1143
avahi_strerror(avahi_server_errno(mc.server)));
1917
exitcode = EX_UNAVAILABLE;
1918
goto end;
1919
}
1920
1921
if(quit_now){
1144
exitcode = EXIT_FAILURE;
1922
1145
goto end;
1923
1146
}
1924
1147
1927
1150
if(debug){
1928
1151
fprintf(stderr, "Starting Avahi loop search\n");
1929
1152
}
1930
1931
ret = avahi_loop_with_timeout(mc.simple_poll,
1932
(int)(retry_interval * 1000));
1933
if(debug){
1934
fprintf(stderr, "avahi_loop_with_timeout exited %s\n",
1935
(ret == 0) ? "successfully" : "with error");
1936
}
1153
1154
avahi_simple_poll_loop(mc.simple_poll);
1937
1155
1938
1156
end:
1939
1157
1960
1178
if(gpgme_initialized){
1961
1179
gpgme_release(mc.ctx);
1962
1180
}
1963
1964
/* Cleans up the circular linked list of Mandos servers the client
1965
has seen */
1966
if(mc.current_server != NULL){
1967
mc.current_server->prev->next = NULL;
1968
while(mc.current_server != NULL){
1969
server *next = mc.current_server->next;
1970
free(mc.current_server);
1971
mc.current_server = next;
1972
}
1973
}
1974
1975
/* Take down the network interface */
1976
if(take_down_interface){
1977
/* Re-raise priviliges */
1978
errno = 0;
1979
ret = seteuid(0);
1980
if(ret == -1){
1981
perror_plus("seteuid");
1982
}
1983
if(geteuid() == 0){
1984
ret = ioctl(sd, SIOCGIFFLAGS, &network);
1985
if(ret == -1){
1986
perror_plus("ioctl SIOCGIFFLAGS");
1987
} else if(network.ifr_flags & IFF_UP) {
1988
network.ifr_flags &= ~(short)IFF_UP; /* clear flag */
1989
ret = ioctl(sd, SIOCSIFFLAGS, &network);
1990
if(ret == -1){
1991
perror_plus("ioctl SIOCSIFFLAGS -IFF_UP");
1992
}
1993
}
1994
ret = (int)TEMP_FAILURE_RETRY(close(sd));
1995
if(ret == -1){
1996
perror_plus("close");
1997
}
1998
/* Lower privileges permanently */
1999
errno = 0;
2000
ret = setuid(uid);
2001
if(ret == -1){
2002
perror_plus("setuid");
2003
}
2004
}
2005
}
2006
2007
/* Removes the GPGME temp directory and all files inside */
1181
1182
/* Removes the temp directory used by GPGME */
2008
1183
if(tempdir_created){
2009
struct dirent **direntries = NULL;
2010
struct dirent *direntry = NULL;
2011
int numentries = scandir(tempdir, &direntries, notdotentries,
2012
alphasort);
2013
if (numentries > 0){
2014
for(int i = 0; i < numentries; i++){
2015
direntry = direntries[i];
1184
DIR *d;
1185
struct dirent *direntry;
1186
d = opendir(tempdir);
1187
if(d == NULL){
1188
if(errno != ENOENT){
1189
perror("opendir");
1190
}
1191
} else {
1192
while(true){
1193
direntry = readdir(d);
1194
if(direntry == NULL){
1195
break;
1196
}
1197
/* Skip "." and ".." */
1198
if(direntry->d_name[0] == '.'
1199
and (direntry->d_name[1] == '\0'
1200
or (direntry->d_name[1] == '.'
1201
and direntry->d_name[2] == '\0'))){
1202
continue;
1203
}
2016
1204
char *fullname = NULL;
2017
1205
ret = asprintf(&fullname, "%s/%s", tempdir,
2018
1206
direntry->d_name);
2019
1207
if(ret < 0){
2020
perror_plus("asprintf");
1208
perror("asprintf");
2021
1209
continue;
2022
1210
}
2023
1211
ret = remove(fullname);
2027
1215
}
2028
1216
free(fullname);
2029
1217
}
2030
}
2031
2032
/* need to clean even if 0 because man page doesn't specify */
2033
free(direntries);
2034
if (numentries == -1){
2035
perror_plus("scandir");
1218
closedir(d);
2036
1219
}
2037
1220
ret = rmdir(tempdir);
2038
1221
if(ret == -1 and errno != ENOENT){
2039
perror_plus("rmdir");
2040
}
2041
}
2042
2043
if(quit_now){
2044
sigemptyset(&old_sigterm_action.sa_mask);
2045
old_sigterm_action.sa_handler = SIG_DFL;
2046
ret = (int)TEMP_FAILURE_RETRY(sigaction(signal_received,
2047
&old_sigterm_action,
2048
NULL));
2049
if(ret == -1){
2050
perror_plus("sigaction");
2051
}
2052
do {
2053
ret = raise(signal_received);
2054
} while(ret != 0 and errno == EINTR);
2055
if(ret != 0){
2056
perror_plus("raise");
2057
abort();
2058
}
2059
TEMP_FAILURE_RETRY(pause());
1222
perror("rmdir");
1223
}
2060
1224
}
2061
1225
2062
1226
return exitcode;
Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0