FreeBSD Man Pages

unstr(8)

NAME

     strfile, unstr -- create a random access file for storing strings

SYNOPSIS

     strfile [-iorsx] [-c char] source_file [output_file]
     unstr source_file

DESCRIPTION

     Strfile reads a file containing groups of lines separated by a line con-
     taining a single percent `%' sign and creates a data file which contains
     a header structure and a table of file offsets for each group of lines.
     This allows random access of the strings.

     The output file, if not specified on the command line, is named
     source_file.dat.

     The options are as follows:

     -C       Flag the file as containing comments.  This option cases the
	      STR_COMMENTS bit in the header str_flags field to be set.  Com-
	      ments are designated by two delimiter characters at the begin-
	      ning of the line, though strfile does not give any special
	      treatment to comment lines.

     -c char  Change the delimiting character from the percent sign to char.

     -i       Ignore case when ordering the strings.

     -o       Order the strings in alphabetical order.	The offset table will
	      be sorted in the alphabetical order of the groups of lines ref-
	      erenced.	Any initial non-alphanumeric characters are ignored.
	      This option causes the STR_ORDERED bit in the header str_flags
	      field to be set.

     -r       Randomize access to the strings.	Entries in the offset table
	      will be randomly ordered.  This option causes the STR_RANDOM bit
	      in the header str_flags field to be set.

     -s       Run silently; don't give a summary message when finished.

     -x       Note that each alphabetic character in the groups of lines is
	      rotated 13 positions in a simple caesar cypher.  This option
	      causes the STR_ROTATED bit in the header str_flags field to be
	      set.

     The format of the header is:

     #define VERSION 1
     unsigned long   str_version;    /* version number */
     unsigned long   str_numstr;     /* # of strings in the file */
     unsigned long   str_longlen;    /* length of longest string */
     unsigned long   str_shortlen;   /* length of shortest string */
     #define STR_RANDOM      0x1     /* randomized pointers */
     #define STR_ORDERED     0x2     /* ordered pointers */
     #define STR_ROTATED     0x4     /* rot-13'd text */
     unsigned long   str_flags;      /* bit field for flags */
     char str_delim;		     /* delimiting character */

SEE ALSO

     byteorder(3), fortune(6)

FILES

     strfile.dat  default output file.

HISTORY

     The strfile utility first appeared in 4.4BSD.

FreeBSD 5.4			 June 9, 1993			   FreeBSD 5.4

SPONSORED LINKS