NAME

orb2disk - save orb packets into multiple disk files

SYNOPSIS

orb2disk [-b bury-interval] [-m match] [-r reject] [-p period] [-s size] [-vv] orb directory [start-time [end]]

DESCRIPTION

orb2disk saves packets into forb(5) segment files inside the specified directory. The total size of the directory and the size of individual segment files is limited, but may potentially be much larger than the limit on an orbserver(1).

When started for the first time, or when resurrection from the state file fails, orb2disk positions the read at the specified start-time. If no start-time is specified, orb2disk starts with the oldest packet.

When an end time is specified, orb2disk quits after reading a packet with a later time. If the specified end time is last, it copies until reaching the current last packet in the orb.

OPTIONS

FILES

The forb segment files inside the directory are named after the time and pktid of the first packet inside the orb, ie <time>.<pktid>. The pktid does not correspond to the pktid from the orb, and runs the full range of values from zero to 2^32-1. This range ultimately places another limit on the maximum size of directory.

orb2disk also saves a state file into this directory; this state file keeps track of the position in the orbserver from which packets are being copied.

EXAMPLE


% orb2disk ruper:brtt disk
orb2disk: orb2disk : $Revision: 1.5 $ $Date: 2006/09/13 04:56:33 $
orb2disk: resurrection unsuccessful
starting pktid is #3099 TA_H03A/log  4/26/2006   8:35:41.272

orb2disk: Disk files
  disk  (0 segment files currently)
   Current size      =      0.0 Mbytes
   Max size          =   1000.0 Mbytes
   Available         =  23482.1 Mbytes

^C
14316 1124 byte packets (15714 kbytes) in 4.982 seconds
          3154.007 kbytes/s
         25232.055 kbaud
           2873.374 pkts/s

% orb2disk -s 5G -r '.*/st' ruper:brtt disk
orb2disk: orb2disk : $Revision: 1.5 $ $Date: 2006/09/13 04:56:33 $
orb2disk: read old state file
orb2disk: resurrection successful: repositioned to pktid #17415 @  4/26/2006  10:14:40.693
starting pktid is #17415 TA_W12A/log  4/26/2006  10:14:40.693

orb2disk: Disk files
  disk  (2 segment files currently)
   Current size      =     16.7 Mbytes
   Max size          =   5368.7 Mbytes
   Available         =  23465.4 Mbytes

^C
974 49964 byte packets (47524 kbytes) in 5.480 seconds
          8672.948 kbytes/s
         69383.585 kbaud
            177.751 pkts/s

SEE ALSO

orbserver(1)
diskserver(1)
forb(5)

BUGS AND CAVEATS

Unlike orbserver, orb2disk may adjust the total size of the disk segments at each execution. If you specify a larger size at startup, it will begin to fill up to the larger size; if you specify a smaller size, then older segments will soon be deleted until the new smaller size is attained.

Similarly, the size is not fixed, but grows steadily as packets are added to a segment, then drops by large amounts are whole segments are deleted to keep the size (roughly) below the specified size.

AUTHOR

Daniel Quinlan

Table of Contents
Antelope Release 4.8 Darwin 8.7.0 2006-09-20
Boulder Real Time Technologies, Inc For more information, contact support@brtt.com