source: lib/format_linux_common.c @ 89e2ff7

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivendag_formatrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since 89e2ff7 was 1d780e4, checked in by Shane Alcock <salcock@…>, 4 years ago

Fix some basic warnings

Also fixed spelling of 'statistics' in internal function name.

  • Property mode set to 100644
File size: 18.5 KB
Line 
1/*
2 *
3 * Copyright (c) 2007-2016 The University of Waikato, Hamilton, New Zealand.
4 * All rights reserved.
5 *
6 * This file is part of libtrace.
7 *
8 * This code has been developed by the University of Waikato WAND
9 * research group. For further information please see http://www.wand.net.nz/
10 *
11 * libtrace is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU Lesser General Public License as published by
13 * the Free Software Foundation; either version 3 of the License, or
14 * (at your option) any later version.
15 *
16 * libtrace is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19 * GNU Lesser General Public License for more details.
20 *
21 * You should have received a copy of the GNU Lesser General Public License
22 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
23 *
24 *
25 */
26
27/* This file contains the common functions used by both the ring and int
28 * formats.
29 *
30 * Typically these deal with the socket descriptor or common conversions.
31 */
32
33#include "config.h"
34#include "libtrace.h"
35#include "libtrace_int.h"
36#include "format_helper.h"
37#include "libtrace_arphrd.h"
38#include <stdlib.h>
39#include <errno.h>
40#include <unistd.h>
41#include <string.h>
42#include <assert.h>
43
44#ifdef HAVE_INTTYPES_H
45#  include <inttypes.h>
46#else
47# error "Can't find inttypes.h"
48#endif
49
50#include "format_linux_common.h"
51
52#ifdef HAVE_NETPACKET_PACKET_H
53
54int linuxcommon_probe_filename(const char *filename)
55{
56        /* Is this an interface? */
57        return (if_nametoindex(filename) != 0);
58}
59
60/* Compiles a libtrace BPF filter for use with a linux native socket */
61static int linuxnative_configure_bpf(libtrace_t *libtrace,
62                libtrace_filter_t *filter) {
63#ifdef HAVE_LIBPCAP
64        struct ifreq ifr;
65        unsigned int arphrd;
66        libtrace_dlt_t dlt;
67        libtrace_filter_t *f;
68        int sock;
69        pcap_t *pcap;
70
71        /* Take a copy of the filter object as it was passed in */
72        f = (libtrace_filter_t *) malloc(sizeof(libtrace_filter_t));
73        memcpy(f, filter, sizeof(libtrace_filter_t));
74
75        /* If we are passed a filter with "flag" set to zero, then we must
76         * compile the filterstring before continuing. This involves
77         * determining the linktype, passing the filterstring to libpcap to
78         * compile, and saving the result for trace_start() to push into the
79         * kernel.
80         * If flag is set to one, then the filter was probably generated using
81         * trace_create_filter_from_bytecode() and so we don't need to do
82         * anything (we've just copied it above).
83         */
84        if (f->flag == 0) {
85                sock = socket(PF_INET, SOCK_STREAM, 0);
86                memset(&ifr, 0, sizeof(struct ifreq));
87                strncpy(ifr.ifr_name, libtrace->uridata, IF_NAMESIZE);
88                if (ioctl(sock, SIOCGIFHWADDR, &ifr) != 0) {
89                        perror("Can't get HWADDR for interface");
90                        return -1;
91                }
92                close(sock);
93
94                arphrd = ifr.ifr_hwaddr.sa_family;
95                dlt = libtrace_to_pcap_dlt(arphrd_type_to_libtrace(arphrd));
96
97                pcap = pcap_open_dead(dlt,
98                                FORMAT_DATA->snaplen);
99
100                if (pcap_compile(pcap, &f->filter, f->filterstring, 0, 0) == -1) {
101                        /* Filter didn't compile, set flag to 0 so we can
102                         * detect this when trace_start() is called and
103                         * produce a useful error
104                         */
105                        f->flag = 0;
106                        trace_set_err(libtrace, TRACE_ERR_INIT_FAILED,
107                                      "Failed to compile BPF filter (%s): %s",
108                                      f->filterstring, pcap_geterr(pcap));
109                } else {
110                        /* Set the "flag" to indicate that the filterstring
111                         * has been compiled
112                         */
113                        f->flag = 1;
114                }
115
116                pcap_close(pcap);
117
118        }
119
120        if (FORMAT_DATA->filter != NULL)
121                free(FORMAT_DATA->filter);
122
123        FORMAT_DATA->filter = f;
124
125        return 0;
126#else
127        return -1
128#endif
129}
130
131int linuxcommon_config_input(libtrace_t *libtrace,
132                trace_option_t option,
133                void *data)
134{
135        switch(option) {
136                case TRACE_OPTION_SNAPLEN:
137                        FORMAT_DATA->snaplen=*(int*)data;
138                        return 0;
139                case TRACE_OPTION_PROMISC:
140                        FORMAT_DATA->promisc=*(int*)data;
141                        return 0;
142                case TRACE_OPTION_FILTER:
143                        return linuxnative_configure_bpf(libtrace,
144                                        (libtrace_filter_t *) data);
145                case TRACE_OPTION_HASHER:
146                        switch (*((enum hasher_types *)data)) {
147                                case HASHER_BALANCE:
148                                        // Do fanout
149                                        FORMAT_DATA->fanout_flags = PACKET_FANOUT_LB;
150                                        // Or we could balance to the CPU
151                                        return 0;
152                                case HASHER_BIDIRECTIONAL:
153                                case HASHER_UNIDIRECTIONAL:
154                                        FORMAT_DATA->fanout_flags = PACKET_FANOUT_HASH;
155                                        return 0;
156                                case HASHER_CUSTOM:
157                                        return -1;
158                        }
159                        break;
160                case TRACE_OPTION_META_FREQ:
161                        /* No meta-data for this format */
162                        break;
163                case TRACE_OPTION_EVENT_REALTIME:
164                        /* Live captures are always going to be in trace time */
165                        break;
166                /* Avoid default: so that future options will cause a warning
167                 * here to remind us to implement it, or flag it as
168                 * unimplementable
169                 */
170        }
171
172        /* Don't set an error - trace_config will try to deal with the
173         * option and will set an error if it fails */
174        return -1;
175}
176
177int linuxcommon_init_input(libtrace_t *libtrace)
178{
179        struct linux_per_stream_t stream_data = ZERO_LINUX_STREAM;
180
181        libtrace->format_data = (struct linux_format_data_t *)
182                malloc(sizeof(struct linux_format_data_t));
183        assert(libtrace->format_data != NULL);
184
185        FORMAT_DATA->per_stream =
186                libtrace_list_init(sizeof(stream_data));
187        assert(FORMAT_DATA->per_stream != NULL);
188
189        libtrace_list_push_back(FORMAT_DATA->per_stream, &stream_data);
190
191        FORMAT_DATA->promisc = -1;
192        FORMAT_DATA->snaplen = LIBTRACE_PACKET_BUFSIZE;
193        FORMAT_DATA->filter = NULL;
194        FORMAT_DATA->stats_valid = 0;
195        FORMAT_DATA->stats.tp_drops = 0;
196        FORMAT_DATA->stats.tp_packets = 0;
197        FORMAT_DATA->max_order = MAX_ORDER;
198        FORMAT_DATA->fanout_flags = PACKET_FANOUT_LB;
199        /* Some examples use pid for the group however that would limit a single
200         * application to use only int/ring format, instead using rand */
201        FORMAT_DATA->fanout_group = (uint16_t) rand();
202        return 0;
203}
204
205int linuxcommon_init_output(libtrace_out_t *libtrace)
206{
207        libtrace->format_data = (struct linux_format_data_out_t*)
208                malloc(sizeof(struct linux_format_data_out_t));
209        assert(libtrace->format_data != NULL);
210
211        FORMAT_DATA_OUT->fd = -1;
212        FORMAT_DATA_OUT->tx_ring = NULL;
213        FORMAT_DATA_OUT->txring_offset = 0;
214        FORMAT_DATA_OUT->queue = 0;
215        FORMAT_DATA_OUT->max_order = MAX_ORDER;
216        return 0;
217}
218
219/* Close an input stream, this is safe to be called part way through
220 * initilisation as a cleanup function assuming streams were set to
221 * ZERO_LINUX_STREAM to begin with.
222 *
223 * This works correctly with both int and ring
224 */
225void linuxcommon_close_input_stream(libtrace_t *libtrace,
226                                    struct linux_per_stream_t *stream) {
227        if (stream->fd != -1)
228                close(stream->fd);
229        stream->fd = -1;
230        if (stream->rx_ring != MAP_FAILED)
231                munmap(stream->rx_ring,
232                       stream->req.tp_block_size *
233                       stream->req.tp_block_nr);
234        stream->rx_ring = MAP_FAILED;
235        stream->rxring_offset = 0;
236        FORMAT_DATA->dev_stats.if_name[0] = 0;
237}
238
239#define REPEAT_16(x) x x x x x x x x x x x x x x x x
240#define xstr(s) str(s)
241#define str(s) #s
242
243/* These don't typically reset however an interface does exist to reset them */
244static int linuxcommon_get_dev_statistics(libtrace_t *libtrace, struct linux_dev_stats *stats) {
245        FILE *file;
246        char line[1024];
247        struct linux_dev_stats tmp_stats;
248
249        file = fopen("/proc/net/dev","r");
250        if (file == NULL) {
251                return -1;
252        }
253
254        /* Skip 2 header lines */
255        if (fgets(line, sizeof(line), file) == NULL) {
256                fclose(file);
257                return -1;
258        }
259
260        if (fgets(line, sizeof(line), file) == NULL) {
261                fclose(file);
262                return -1;
263        }
264
265        while (!(feof(file)||ferror(file))) {
266                int tot;
267                if (fgets(line, sizeof(line), file) == NULL)
268                        break;
269
270                tot = sscanf(line, " %"xstr(IF_NAMESIZE)"[^:]:" REPEAT_16(" %"SCNd64),
271                             tmp_stats.if_name,
272                             &tmp_stats.rx_bytes,
273                             &tmp_stats.rx_packets,
274                             &tmp_stats.rx_errors,
275                             &tmp_stats.rx_drops,
276                             &tmp_stats.rx_fifo,
277                             &tmp_stats.rx_frame,
278                             &tmp_stats.rx_compressed,
279                             &tmp_stats.rx_multicast,
280                             &tmp_stats.tx_bytes,
281                             &tmp_stats.tx_packets,
282                             &tmp_stats.tx_errors,
283                             &tmp_stats.tx_drops,
284                             &tmp_stats.tx_fifo,
285                             &tmp_stats.tx_colls,
286                             &tmp_stats.tx_carrier,
287                             &tmp_stats.tx_compressed);
288                if (tot != 17)
289                        continue;
290                if (strncmp(tmp_stats.if_name, libtrace->uridata, IF_NAMESIZE) == 0) {
291                        *stats = tmp_stats;
292                        fclose(file);
293                        return 0;
294                }
295        }
296        fclose(file);
297        return -1;
298}
299
300/* Start an input stream
301 * - Opens the file descriptor
302 * - Sets promiscuous correctly
303 * - Sets socket option
304 * - Add BPF filter
305 *
306 * The output is ready for int directly, for ring the conversion to ring still
307 * needs to take place.
308 */
309int linuxcommon_start_input_stream(libtrace_t *libtrace,
310                                   struct linux_per_stream_t *stream)
311{
312        struct sockaddr_ll addr;
313        const int one = 1;
314        memset(&addr,0,sizeof(addr));
315        libtrace_filter_t *filter = FORMAT_DATA->filter;
316
317        /* Create a raw socket for reading packets on */
318        stream->fd = socket(PF_PACKET, SOCK_RAW, htons(ETH_P_ALL));
319        if (stream->fd==-1) {
320                trace_set_err(libtrace, errno, "Could not create raw socket");
321                return -1;
322        }
323
324        /* Bind to the capture interface */
325        addr.sll_family = AF_PACKET;
326        addr.sll_protocol = htons(ETH_P_ALL);
327        if (strlen(libtrace->uridata)) {
328                addr.sll_ifindex = if_nametoindex(libtrace->uridata);
329                if (addr.sll_ifindex == 0) {
330                        linuxcommon_close_input_stream(libtrace, stream);
331                        trace_set_err(libtrace, TRACE_ERR_INIT_FAILED,
332                                      "Failed to find interface %s",
333                                      libtrace->uridata);
334                        return -1;
335                }
336        } else {
337                addr.sll_ifindex = 0;
338        }
339        if (bind(stream->fd,
340                 (struct sockaddr*)&addr,
341                 (socklen_t)sizeof(addr))==-1) {
342                linuxcommon_close_input_stream(libtrace, stream);
343                trace_set_err(libtrace, errno,
344                              "Failed to bind to interface %s",
345                              libtrace->uridata);
346                return -1;
347        }
348
349        /* If promisc hasn't been specified, set it to "true" if we're
350         * capturing on one interface, or "false" if we're capturing on
351         * all interfaces.
352         */
353        if (FORMAT_DATA->promisc==-1) {
354                if (addr.sll_ifindex!=0)
355                        FORMAT_DATA->promisc=1;
356                else
357                        FORMAT_DATA->promisc=0;
358        }
359
360        /* Enable promiscuous mode, if requested */
361        if (FORMAT_DATA->promisc) {
362                struct packet_mreq mreq;
363                socklen_t socklen = sizeof(mreq);
364                memset(&mreq,0,sizeof(mreq));
365                mreq.mr_ifindex = addr.sll_ifindex;
366                mreq.mr_type = PACKET_MR_PROMISC;
367                if (setsockopt(stream->fd,
368                               SOL_PACKET,
369                               PACKET_ADD_MEMBERSHIP,
370                               &mreq,
371                               socklen)==-1) {
372                        perror("setsockopt(PROMISC)");
373                }
374        }
375
376        /* Set the timestamp option on the socket - aim for the most detailed
377         * clock resolution possible */
378#ifdef SO_TIMESTAMPNS
379        if (setsockopt(stream->fd,
380                       SOL_SOCKET,
381                       SO_TIMESTAMPNS,
382                       &one,
383                       (socklen_t)sizeof(one))!=-1) {
384                FORMAT_DATA->timestamptype = TS_TIMESPEC;
385        }
386        else
387        /* DANGER: This is a dangling else to only do the next setsockopt()
388         * if we fail the first! */
389#endif
390                if (setsockopt(stream->fd,
391                               SOL_SOCKET,
392                               SO_TIMESTAMP,
393                               &one,
394                               (socklen_t)sizeof(one))!=-1) {
395                        FORMAT_DATA->timestamptype = TS_TIMEVAL;
396                }
397                else
398                        FORMAT_DATA->timestamptype = TS_NONE;
399
400        /* Push BPF filter into the kernel. At this stage we can safely assume
401         * that the filterstring has been compiled, or the filter was supplied
402         * pre-compiled.
403         */
404        if (filter != NULL) {
405                /* Check if the filter was successfully compiled. If not,
406                 * it is probably a bad filter and we should return an error
407                 * before the caller tries to read any packets */
408                if (filter->flag == 0) {
409                        linuxcommon_close_input_stream(libtrace, stream);
410                        trace_set_err(libtrace, TRACE_ERR_BAD_FILTER,
411                                      "Cannot attach a bad filter to %s",
412                                      libtrace->uridata);
413                        return -1;
414                }
415
416                if (setsockopt(stream->fd,
417                               SOL_SOCKET,
418                               SO_ATTACH_FILTER,
419                               &filter->filter,
420                               sizeof(filter->filter)) == -1) {
421                        perror("setsockopt(SO_ATTACH_FILTER)");
422                }
423        }
424
425        /* Consume any buffered packets that were received before the socket
426         * was properly setup, including those which missed the filter and
427         * bind()ing to an interface.
428         *
429         * If packet rate is high this could therotically hang forever. 4K
430         * should be a large enough limit.
431         */
432        int count = 0;
433        void *buf = malloc((size_t)LIBTRACE_PACKET_BUFSIZE);
434        while(count < 4096 &&
435                recv(stream->fd,
436                   buf,
437                   (size_t)LIBTRACE_PACKET_BUFSIZE,
438                   MSG_DONTWAIT) != -1) { count++; }
439        free(buf);
440
441        /* Mark that the stats are valid and apply an offset */
442        FORMAT_DATA->stats_valid = 1;
443        /* Offset by number we ate for each stream and reset stats after pause */
444        FORMAT_DATA->stats.tp_packets = -count;
445        FORMAT_DATA->stats.tp_drops = 0;
446
447        if (linuxcommon_get_dev_statistics(libtrace, &FORMAT_DATA->dev_stats) != 0) {
448                /* Mark this as bad */
449                FORMAT_DATA->dev_stats.if_name[0] = 0;
450        }
451
452        return 0;
453}
454
455int linuxcommon_pause_input(libtrace_t *libtrace)
456{
457        size_t i;
458
459        /* Stop and detach each stream */
460        for (i = 0; i < libtrace_list_get_size(FORMAT_DATA->per_stream); ++i) {
461                struct linux_per_stream_t *stream;
462                stream = libtrace_list_get_index(FORMAT_DATA->per_stream, i)->data;
463                linuxcommon_close_input_stream(libtrace, stream);
464        }
465
466        return 0;
467}
468
469int linuxcommon_fin_input(libtrace_t *libtrace)
470{
471        if (libtrace->format_data) {
472                if (FORMAT_DATA->filter != NULL)
473                        free(FORMAT_DATA->filter);
474
475                if (FORMAT_DATA->per_stream)
476                        libtrace_list_deinit(FORMAT_DATA->per_stream);
477
478                free(libtrace->format_data);
479        }
480
481        return 0;
482}
483
484int linuxcommon_pregister_thread(libtrace_t *libtrace,
485                                 libtrace_thread_t *t,
486                                 bool reading) {
487        if (reading) {
488                /* XXX TODO remove this oneday make sure hasher thread still works */
489                struct linux_per_stream_t *stream;
490                stream = libtrace_list_get_index(FORMAT_DATA->per_stream,
491                                                 t->perpkt_num)->data;
492                t->format_data = stream;
493                if (!stream) {
494                        /* This should never happen and indicates an
495                         * internal libtrace bug */
496                        trace_set_err(libtrace, TRACE_ERR_INIT_FAILED,
497                                      "Failed to attached thread %d to a stream",
498                                      t->perpkt_num);
499                        return -1;
500                }
501        }
502        return 0;
503}
504
505/* These counters reset with each read */
506static void linuxcommon_update_socket_statistics(libtrace_t *libtrace) {
507        struct tpacket_stats stats;
508        size_t i;
509        socklen_t len = sizeof(stats);
510
511        for (i = 0; i < libtrace_list_get_size(FORMAT_DATA->per_stream); ++i) {
512                struct linux_per_stream_t *stream;
513                stream = libtrace_list_get_index(FORMAT_DATA->per_stream, i)->data;
514                if (stream->fd != -1) {
515                        if (getsockopt(stream->fd,
516                                   SOL_PACKET,
517                                   PACKET_STATISTICS,
518                                   &stats,
519                                   &len) == 0) {
520                                if (FORMAT_DATA->stats_valid==0) {
521                                        FORMAT_DATA->stats.tp_drops = stats.tp_drops;
522                                        FORMAT_DATA->stats.tp_packets = stats.tp_packets;
523                                        FORMAT_DATA->stats_valid = 1;
524                                } else {
525                                        FORMAT_DATA->stats.tp_drops += stats.tp_drops;
526                                        FORMAT_DATA->stats.tp_packets += stats.tp_packets;
527                                }
528                        } else {
529                                perror("getsockopt PACKET_STATISTICS failed");
530                        }
531                }
532        }
533}
534
535#define DEV_DIFF(x) (dev_stats.x - FORMAT_DATA->dev_stats.x)
536/* Note these statistics come from two different sources, the socket itself and
537 * the linux device. As such this means it is highly likely that their is some
538 * margin of error in the returned statistics, we perform basic sanitising so
539 * that these are not too noticable.
540 */
541void linuxcommon_get_statistics(libtrace_t *libtrace, libtrace_stat_t *stat) {
542        struct linux_dev_stats dev_stats;
543        if (libtrace->format_data == NULL)
544                return;
545        /* Do we need to consider the case after the trace is closed? */
546        if (FORMAT_DATA_FIRST->fd == -1) {
547                /* This is probably a 'dead' trace so obviously we can't query
548                 * the socket for capture counts, can we? */
549                return;
550        }
551
552        dev_stats.if_name[0] = 0; /* This will be set if we retrive valid stats */
553        /* Do we have starting stats to compare to? */
554        if (FORMAT_DATA->dev_stats.if_name[0] != 0) {
555                linuxcommon_get_dev_statistics(libtrace, &dev_stats);
556        }
557        linuxcommon_update_socket_statistics(libtrace);
558
559        /* filtered count == dev received - socket received */
560        if (FORMAT_DATA->filter != NULL &&
561            FORMAT_DATA->stats_valid &&
562            dev_stats.if_name[0]) {
563                uint64_t filtered = DEV_DIFF(rx_packets) -
564                                    FORMAT_DATA->stats.tp_packets;
565                /* Check the value is sane, due to timing it could be below 0 */
566                if (filtered < UINT64_MAX - 100000) {
567                        stat->filtered += filtered;
568                }
569        }
570
571        /* dropped count == socket dropped + dev dropped */
572        if (FORMAT_DATA->stats_valid) {
573                stat->dropped_valid = 1;
574                stat->dropped = FORMAT_DATA->stats.tp_drops;
575                if (dev_stats.if_name[0]) {
576                        stat->dropped += DEV_DIFF(rx_drops);
577                }
578        }
579
580        /* received count - All good packets even those dropped or filtered */
581        if (dev_stats.if_name[0]) {
582                stat->received_valid = 1;
583                stat->received = DEV_DIFF(rx_packets) + DEV_DIFF(rx_drops);
584        }
585
586        /* captured count - received and but not dropped */
587        if (dev_stats.if_name[0] && FORMAT_DATA->stats_valid) {
588                stat->captured_valid = 1;
589                stat->captured = DEV_DIFF(rx_packets) - FORMAT_DATA->stats.tp_drops;
590        }
591
592        /* errors */
593        if (dev_stats.if_name[0]) {
594                stat->errors_valid = 1;
595                stat->errors = DEV_DIFF(rx_errors);
596        }
597
598}
599
600int linuxcommon_get_fd(const libtrace_t *libtrace) {
601        if (libtrace->format_data == NULL)
602                return -1;
603        return FORMAT_DATA_FIRST->fd;
604}
605
606int linuxcommon_pstart_input(libtrace_t *libtrace,
607                             int (*start_stream)(libtrace_t *, struct linux_per_stream_t*)) {
608        int i = 0;
609        int tot = libtrace->perpkt_thread_count;
610        int iserror = 0;
611        struct linux_per_stream_t empty_stream = ZERO_LINUX_STREAM;
612
613        for (i = 0; i < tot; ++i)
614        {
615                struct linux_per_stream_t *stream;
616                /* Add storage for another stream */
617                if (libtrace_list_get_size(FORMAT_DATA->per_stream) <= (size_t) i)
618                        libtrace_list_push_back(FORMAT_DATA->per_stream, &empty_stream);
619
620                stream = libtrace_list_get_index(FORMAT_DATA->per_stream, i)->data;
621                if (start_stream(libtrace, stream) != 0) {
622                        iserror = 1;
623                        break;
624                }
625                if (linuxcommon_to_packet_fanout(libtrace, stream) != 0)
626                {
627                        iserror = 1;
628                        close(stream->fd);
629                        stream->fd = -1;
630                        break;
631                }
632        }
633
634        if (iserror) {
635                /* Free those that succeeded */
636                for (i = i - 1; i >= 0; i--) {
637                        struct linux_per_stream_t *stream;
638                        stream = libtrace_list_get_index(FORMAT_DATA->per_stream, i)->data;
639                        linuxcommon_close_input_stream(libtrace, stream);
640                }
641                return -1;
642        }
643
644        return 0;
645}
646
647#else /* HAVE_NETPACKET_PACKET_H */
648
649/* No NETPACKET - So this format is not live */
650void linuxcommon_get_statistics(libtrace_t *libtrace UNUSED,
651                                libtrace_stat_t *stat UNUSED) {
652        return;
653}
654
655#endif /* HAVE_NETPACKET_PACKET_H */
656
Note: See TracBrowser for help on using the repository browser.