1 /* Copyright (C) 2009 Pierre-Marc Fournier
3 * This library is free software; you can redistribute it and/or
4 * modify it under the terms of the GNU Lesser General Public
5 * License as published by the Free Software Foundation; either
6 * version 2.1 of the License, or (at your option) any later version.
8 * This library is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * Lesser General Public License for more details.
13 * You should have received a copy of the GNU Lesser General Public
14 * License along with this library; if not, write to the Free Software
15 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 #include <sys/types.h>
39 /* return value: 0 = subbuffer is finished, it won't produce data anymore
40 * 1 = got subbuffer successfully
44 #define GET_SUBBUF_OK 1
45 #define GET_SUBBUF_DONE 0
46 #define GET_SUBBUF_DIED 2
48 #define PUT_SUBBUF_OK 1
49 #define PUT_SUBBUF_DIED 0
50 #define PUT_SUBBUF_PUSHED 2
51 #define PUT_SUBBUF_DONE 3
54 char *trace_path
=NULL
;
58 /* Number of active buffers and the mutex to protect it. */
59 int active_buffers
= 0;
60 pthread_mutex_t active_buffers_mutex
= PTHREAD_MUTEX_INITIALIZER
;
61 /* Whether a request to end the program was received. */
62 sig_atomic_t terminate_req
= 0;
64 int get_subbuffer(struct buffer_info
*buf
)
67 char *received_msg
=NULL
;
72 asprintf(&send_msg
, "get_subbuffer %s", buf
->name
);
73 result
= ustcomm_send_request(&buf
->conn
, send_msg
, &received_msg
);
74 if((result
== -1 && errno
== EPIPE
) || result
== 0) {
75 DBG("app died while being traced");
76 retval
= GET_SUBBUF_DIED
;
80 ERR("get_subbuffer: ustcomm_send_request failed");
85 result
= sscanf(received_msg
, "%as %ld", &rep_code
, &buf
->consumed_old
);
86 if(result
!= 2 && result
!= 1) {
87 ERR("unable to parse response to get_subbuffer");
92 DBG("received msg is %s", received_msg
);
94 if(!strcmp(rep_code
, "OK")) {
95 DBG("got subbuffer %s", buf
->name
);
96 retval
= GET_SUBBUF_OK
;
98 else if(nth_token_is(received_msg
, "END", 0) == 1) {
99 retval
= GET_SUBBUF_DONE
;
102 else if(!strcmp(received_msg
, "NOTFOUND")) {
103 WARN("For buffer %s, the trace was not found. This likely means it was destroyed by the user.", buf
->name
);
104 retval
= GET_SUBBUF_DONE
;
108 DBG("error getting subbuffer %s", buf
->name
);
112 /* FIMXE: free correctly the stuff */
125 int put_subbuffer(struct buffer_info
*buf
)
128 char *received_msg
=NULL
;
133 asprintf(&send_msg
, "put_subbuffer %s %ld", buf
->name
, buf
->consumed_old
);
134 result
= ustcomm_send_request(&buf
->conn
, send_msg
, &received_msg
);
135 if(result
< 0 && errno
== ECONNRESET
) {
136 retval
= PUT_SUBBUF_DIED
;
139 else if(result
< 0) {
140 ERR("put_subbuffer: send_message failed");
144 else if(result
== 0) {
145 /* Program seems finished. However this might not be
146 * the last subbuffer that has to be collected.
148 retval
= PUT_SUBBUF_DIED
;
152 result
= sscanf(received_msg
, "%as", &rep_code
);
154 ERR("unable to parse response to put_subbuffer");
159 if(!strcmp(rep_code
, "OK")) {
160 DBG("subbuffer put %s", buf
->name
);
161 retval
= PUT_SUBBUF_OK
;
163 else if(!strcmp(received_msg
, "NOTFOUND")) {
164 WARN("For buffer %s, the trace was not found. This likely means it was destroyed by the user.", buf
->name
);
165 /* However, maybe this was not the last subbuffer. So
166 * we return the program died.
168 retval
= PUT_SUBBUF_DIED
;
172 DBG("put_subbuffer: received error, we were pushed");
173 retval
= PUT_SUBBUF_PUSHED
;
190 void decrement_active_buffers(void *arg
)
192 pthread_mutex_lock(&active_buffers_mutex
);
194 pthread_mutex_unlock(&active_buffers_mutex
);
197 int create_dir_if_needed(char *dir
)
200 result
= mkdir(dir
, 0777);
202 if(errno
!= EEXIST
) {
211 int is_directory(const char *dir
)
216 result
= stat(dir
, &st
);
222 if(!S_ISDIR(st
.st_mode
)) {
229 struct buffer_info
*connect_buffer(pid_t pid
, const char *bufname
)
231 struct buffer_info
*buf
;
237 struct shmid_ds shmds
;
239 buf
= (struct buffer_info
*) malloc(sizeof(struct buffer_info
));
241 ERR("add_buffer: insufficient memory");
249 result
= ustcomm_connect_app(buf
->pid
, &buf
->conn
);
251 WARN("unable to connect to process, it probably died before we were able to connect");
256 asprintf(&send_msg
, "get_pidunique");
257 result
= ustcomm_send_request(&buf
->conn
, send_msg
, &received_msg
);
260 ERR("problem in ustcomm_send_request(get_pidunique)");
264 result
= sscanf(received_msg
, "%lld", &buf
->pidunique
);
266 ERR("unable to parse response to get_pidunique");
270 DBG("got pidunique %lld", buf
->pidunique
);
273 asprintf(&send_msg
, "get_shmid %s", buf
->name
);
274 result
= ustcomm_send_request(&buf
->conn
, send_msg
, &received_msg
);
277 ERR("problem in ustcomm_send_request(get_shmid)");
281 result
= sscanf(received_msg
, "%d %d", &buf
->shmid
, &buf
->bufstruct_shmid
);
283 ERR("unable to parse response to get_shmid (\"%s\")", received_msg
);
287 DBG("got shmids %d %d", buf
->shmid
, buf
->bufstruct_shmid
);
290 asprintf(&send_msg
, "get_n_subbufs %s", buf
->name
);
291 result
= ustcomm_send_request(&buf
->conn
, send_msg
, &received_msg
);
294 ERR("problem in ustcomm_send_request(g_n_subbufs)");
298 result
= sscanf(received_msg
, "%d", &buf
->n_subbufs
);
300 ERR("unable to parse response to get_n_subbufs");
304 DBG("got n_subbufs %d", buf
->n_subbufs
);
306 /* get subbuf size */
307 asprintf(&send_msg
, "get_subbuf_size %s", buf
->name
);
308 ustcomm_send_request(&buf
->conn
, send_msg
, &received_msg
);
311 result
= sscanf(received_msg
, "%d", &buf
->subbuf_size
);
313 ERR("unable to parse response to get_subbuf_size");
317 DBG("got subbuf_size %d", buf
->subbuf_size
);
320 buf
->mem
= shmat(buf
->shmid
, NULL
, 0);
321 if(buf
->mem
== (void *) 0) {
325 DBG("successfully attached buffer memory");
327 buf
->bufstruct_mem
= shmat(buf
->bufstruct_shmid
, NULL
, 0);
328 if(buf
->bufstruct_mem
== (void *) 0) {
332 DBG("successfully attached buffer bufstruct memory");
334 /* obtain info on the memory segment */
335 result
= shmctl(buf
->shmid
, IPC_STAT
, &shmds
);
340 buf
->memlen
= shmds
.shm_segsz
;
342 /* open file for output */
344 /* Only create the directory if using the default path, because
345 * of the risk of typo when using trace path override. We don't
346 * want to risk creating plenty of useless directories in that case.
348 result
= create_dir_if_needed(USTD_DEFAULT_TRACE_PATH
);
350 ERR("could not create directory %s", USTD_DEFAULT_TRACE_PATH
);
354 trace_path
= USTD_DEFAULT_TRACE_PATH
;
357 asprintf(&tmp
, "%s/%u_%lld", trace_path
, buf
->pid
, buf
->pidunique
);
358 result
= create_dir_if_needed(tmp
);
360 ERR("could not create directory %s", tmp
);
366 asprintf(&tmp
, "%s/%u_%lld/%s", trace_path
, buf
->pid
, buf
->pidunique
, buf
->name
);
367 result
= fd
= open(tmp
, O_WRONLY
| O_CREAT
| O_TRUNC
| O_EXCL
, 00600);
370 ERR("failed opening trace file %s", tmp
);
376 pthread_mutex_lock(&active_buffers_mutex
);
378 pthread_mutex_unlock(&active_buffers_mutex
);
383 int write_current_subbuffer(struct buffer_info
*buf
)
387 void *subbuf_mem
= buf
->mem
+ (buf
->consumed_old
& (buf
->n_subbufs
* buf
->subbuf_size
-1));
389 size_t cur_sb_size
= subbuffer_data_size(subbuf_mem
);
391 result
= patient_write(buf
->file_fd
, subbuf_mem
, cur_sb_size
);
394 /* FIXME: maybe drop this trace */
401 int consumer_loop(struct buffer_info
*buf
)
405 pthread_cleanup_push(decrement_active_buffers
, NULL
);
408 /* get the subbuffer */
409 result
= get_subbuffer(buf
);
411 ERR("error getting subbuffer");
414 else if(result
== GET_SUBBUF_DONE
) {
418 else if(result
== GET_SUBBUF_DIED
) {
419 finish_consuming_dead_subbuffer(buf
);
423 /* write data to file */
424 write_current_subbuffer(buf
);
425 /* FIXME: handle return value? */
427 /* put the subbuffer */
428 /* FIXME: we actually should unput the buffer before consuming... */
429 result
= put_subbuffer(buf
);
431 ERR("unknown error putting subbuffer (channel=%s)", buf
->name
);
434 else if(result
== PUT_SUBBUF_PUSHED
) {
435 ERR("Buffer overflow (channel=%s), reader pushed. This channel will not be usable passed this point.", buf
->name
);
438 else if(result
== PUT_SUBBUF_DIED
) {
439 WARN("application died while putting subbuffer");
440 /* FIXME: probably need to skip the first subbuffer in finish_consuming_dead_subbuffer */
441 finish_consuming_dead_subbuffer(buf
);
444 else if(result
== PUT_SUBBUF_DONE
) {
445 /* Done with this subbuffer */
446 /* FIXME: add a case where this branch is used? Upon
447 * normal trace termination, at put_subbuf time, a
448 * special last-subbuffer code could be returned by
453 else if(result
== PUT_SUBBUF_OK
) {
457 DBG("thread for buffer %s is stopping", buf
->name
);
459 /* FIXME: destroy, unalloc... */
461 pthread_cleanup_pop(1);
466 void free_buffer(struct buffer_info
*buf
)
470 struct consumer_thread_args
{
475 void *consumer_thread(void *arg
)
477 struct buffer_info
*buf
= (struct buffer_info
*) arg
;
478 struct consumer_thread_args
*args
= (struct consumer_thread_args
*) arg
;
480 DBG("GOT ARGS: pid %d bufname %s", args
->pid
, args
->bufname
);
482 buf
= connect_buffer(args
->pid
, args
->bufname
);
484 ERR("failed to connect to buffer");
493 /* bufname is free'd in free_buffer() */
498 int start_consuming_buffer(pid_t pid
, const char *bufname
)
501 struct consumer_thread_args
*args
;
503 DBG("beginning of start_consuming_buffer: args: pid %d bufname %s", pid
, bufname
);
505 args
= (struct consumer_thread_args
*) malloc(sizeof(struct consumer_thread_args
));
508 args
->bufname
= strdup(bufname
);
509 DBG("beginning2 of start_consuming_buffer: args: pid %d bufname %s", args
->pid
, args
->bufname
);
511 pthread_create(&thr
, NULL
, consumer_thread
, args
);
512 DBG("end of start_consuming_buffer: args: pid %d bufname %s", args
->pid
, args
->bufname
);
519 fprintf(stderr
, "Usage:\nustd OPTIONS\n\nOptions:\n"
520 "\t-h\t\tDisplay this usage.\n"
521 "\t-o DIR\t\tSpecify the directory where to output the traces.\n"
522 "\t-s PATH\t\tSpecify the path to use for the daemon socket.\n"
523 "\t-d\t\tStart as a daemon.\n"
524 "\t--pidfile FILE\tWrite the PID in this file (when using -d).\n");
527 int parse_args(int argc
, char **argv
)
532 int option_index
= 0;
533 static struct option long_options
[] = {
534 {"pidfile", 1, 0, 'p'},
536 {"version", 0, 0, 'V'},
540 c
= getopt_long(argc
, argv
, "hs:o:d", long_options
, &option_index
);
546 printf("option %s", long_options
[option_index
].name
);
548 printf(" with arg %s", optarg
);
556 if(!is_directory(trace_path
)) {
557 ERR("Not a valid directory. (%s)", trace_path
);
565 pidfile
= strdup(optarg
);
571 printf("Version 0.0\n");
575 /* unknown option or other error; error is
576 printed by getopt, just return */
584 void sigterm_handler(int sig
)
589 static int write_pidfile(const char *file_name
, pid_t pid
)
593 pidfp
= fopen(file_name
, "w");
595 PERROR("fopen (%s)", pidfile
);
596 WARN("killing child process");
600 fprintf(pidfp
, "%d\n", pid
);
607 int start_ustd(int fd
)
609 struct ustcomm_ustd ustd
;
614 result
= sigemptyset(&sigset
);
616 PERROR("sigemptyset");
619 sa
.sa_handler
= sigterm_handler
;
621 sa
.sa_flags
= SA_RESTART
;
622 result
= sigaction(SIGTERM
, &sa
, NULL
);
628 result
= ustcomm_init_ustd(&ustd
, sock_path
);
630 ERR("failed to initialize socket");
634 /* setup handler for SIGPIPE */
635 result
= sigemptyset(&sigset
);
637 PERROR("sigemptyset");
640 result
= sigaddset(&sigset
, SIGPIPE
);
645 result
= sigprocmask(SIG_BLOCK
, &sigset
, NULL
);
647 PERROR("sigprocmask");
653 result
= write_pidfile(pidfile
, getpid());
655 ERR("failed to write pidfile");
660 /* Notify parent that we are successfully started. */
662 /* write any one character */
663 result
= write(fd
, "!", 1);
669 ERR("Problem sending confirmation of daemon start to parent");
682 /* check for requests on our public socket */
683 result
= ustcomm_ustd_recv_message(&ustd
, &recvbuf
, NULL
, 100);
685 ERR("error in ustcomm_ustd_recv_message");
689 if(!strncmp(recvbuf
, "collect", 7)) {
694 result
= sscanf(recvbuf
, "%*s %d %50as", &pid
, &bufname
);
696 ERR("parsing error: %s", recvbuf
);
700 result
= start_consuming_buffer(pid
, bufname
);
702 ERR("error in add_buffer");
716 pthread_mutex_lock(&active_buffers_mutex
);
717 if(active_buffers
== 0) {
718 pthread_mutex_unlock(&active_buffers_mutex
);
721 pthread_mutex_unlock(&active_buffers_mutex
);
728 int start_ustd_daemon()
736 result
= child_pid
= fork();
741 else if(result
== 0) {
742 return start_ustd(fd
[1]);
747 result
= read(fd
[0], &buf
, 1);
753 ERR("did not receive valid confirmation that the daemon is started");
757 result
= close(fd
[0]);
762 DBG("The daemon is now successfully started");
765 /* Wait for confirmation that the server is ready. */
771 int main(int argc
, char **argv
)
775 result
= parse_args(argc
, argv
);
781 result
= start_ustd_daemon();
784 result
= start_ustd(-1);