fstrm_capture(1)            General Commands Manual           fstrm_capture(1)



<?><?><?> (NAME)
       fstrm_capture - <?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> Frame Streams <?><?> <?><?><?><?>


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       fstrm_capture -t content-type -w filename
            [ -u socket-path ] [ -a IP -p port ]
            [ -c max-connections ] [ -b buffer-size ]
            [ -s seconds ] [ --gmtime ] [ --localtime ]
            [ -d [-d ...] ]


       fstrm_capture --type content-type --write filename
            [ --unix socket-path ] [ --tcp IP --port port ]
            [ --maxconns max-connections ] [ --buffersize buffer-size ]
            [ --split seconds ] [ --gmtime ] [ --localtime ]
            [ --debug [--debug ...] ]



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> fstrm_capture <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> (UNIX domain) <?><?> TCP <?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> Frame Streams
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       -w filename | --write filename
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              filename.

              <?><?><?> <?><?><?><?><?> --gmtime <?><?> --localtime
              <?><?><?><?> <?><?><?> <?><?><?><?><?> filename <?><?>
              <?><?><?><?><?><?><?> <?><?> strftime()
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?> filename <?><?><?><?><?> <?><?> <<->> <?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              fstrm_capture <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> (-s) <?><?> <?><?><?><?><?><?><?><?> <?><?>
              filename <?><?><?><?><?> <<->> <?><?><?><?><?><?><?> <?><?><?>.

              <?><?><?><?><?> <?><?><?><?><?><?> SIGHUP <?><?> fstrm_capture
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> (flush)
              <?><?><?><?><?><?>. <?><?><?><?><?> SIGUSR1 <?><?><?><?> <?><?>
              <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?>.


       -t content-type | --type content-type
              <?><?><?><?> <?><?><?><?> content-type <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?> <?><?><?><?><?>
              <?><?> filename <?><?><?><?><?>.


       -u socket-path | --unix socket-path
              <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> socket-path <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> Frame Streams. <?><?><?><?> <?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> -u <?><?> -a
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.


       -a IP | --tcp IP
              <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> TCP
              <?><?><?> <?><?><?><?> IP <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> Frame Streams. <?><?><?><?> <?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> -u <?><?> -a
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.
              <?><?><?><?><?><?><?> <?><?> -a <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> -p <?><?><?>.


       -p port | --port port
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> -a<?> <?><?>
              <?><?><?><?> TCP <?><?> <?><?><?><?><?> port <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> Frame Streams
              <?><?><?> <?><?><?> <?><?><?><?><?><?>.


       -c max-conns | --maxconns max-conns
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> max-conns
              <?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.


       -b buffersize | --buffersize buffersize
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> buffersize.  <?><?> <?><?><?><?><?> <?><?> -c<?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> fstrm_capture <?><?><?><?><?><?><?> <?><?><?>.
              <?><?><?><?><?> buffersize <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              fstrm_capture <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> buffersize<?> <?><?>
              <?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> (framing overhead)<?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?>.

              <?><?><?><?><?> <?><?><?><?><?><?><?> buffersize <?><?><?><?><?>
              <?><?><?><?><?><?> (<?><?><?> <?><?><?><?><?><?><?><?><?>)
              <?><?><?>.


       -s interval | --split interval
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?> interval <?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> --gmtime <?><?> --localtime
              <?><?><?>.

              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>.


       --gmtime
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> --write <?><?> <?><?><?><?>
              strftime() <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> (GMT).  <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> fstrm_capture<?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> --split<?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> SIGUSR1
              <?><?><?><?><?><?><?> <?><?><?>.


       --localtime
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> --write <?><?> <?><?><?><?>
              strftime() <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> fstrm_capture<?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> --split<?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> SIGUSR1
              <?><?><?><?><?><?><?> <?><?><?>.


       -d [ -d ... ] | --debug [ --debug ]
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.
              <?><?><?><?> <?><?><?><?><?> -d<?> <?><?><?><?><?> fstrm_capture
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> -d
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?>
              <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> dnstap <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> (<?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> /var/log/dnstap/dnstap-2018-05-04-12:58:48.fstrm):

            fstrm_capture -t protobuf:dnstap.Dnstap \
                 -u /var/run/named/dnstap.sock \
                 -w /var/log/dnstap/dnstap-%F-%T.fstrm \
                 -s 3600 --gmtime


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       fstrm_dump(1), fstrm_replay(1), strftime(3),
       <?><?><?><?><?><?><?><?> Frame Streams C
       https://farsightsec.github.io/fstrm

                                                              fstrm_capture(1)