NAME
convert_comm - convert original comm table to new schema
SYNOPSIS
convert_comm [-inv] database
SUPPORT
Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.
FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.
DESCRIPTION
After January 2009, I changed the schema extension definiton of the comm
table, to better support additional applications and track additional
information. The new schema has expanded field length for the commtype and
provider as well as the additional fields: dutycycle, power, and equiptype.
Because schema extensions do not support versioning, the schema extension/table
name was kept the same and the
convert_comm script was written to help anyone else
who may have chosen to use this schema extension.
The program convert_comm reads the old format comm table,
and creates a comm table with the commtype and provider fields
extended and fills in the new fields with whitespace.
The original comm table is saved with a suffix of "-". The new format comm
table replaces database.comm.
convert_comm converts a single comm table at a time and does
not have to be run in the particular directory where database.comm resides.
OPTIONS
-
-i
Ask before converting comm table.
-
-n
Just show what would happen.
-
-v
Be more verbose.
EXAMPLE
% convert_comm -i db/usarray
: convert db/usarray.comm ? n
% convert_comm -v usarray
converting usarray.comm
SEE ALSO
comm(5)
mk_dbops(1)
BUGS AND CAVEATS
The following error message can be ignored:
2009-048 22:50:04 perl *complain*: Table 'db.comm' has invalid length 4758.
2009-048 22:50:04 perl *complain*: If more than one process is writing to this database,
**please** turn on locking in the descriptor file.
Not thoroughly tested.
Odd things may happen if the descriptor file basename differs from the
basename of the comm table that is found by following the dbpath.
AUTHOR
Jennifer Eakins
Antelope User Group Contributed Software