Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DBUPGRADE(nged)		     BRL-CAD User Commands	       DBUPGRADE(nged)

NAME
       dbupgrade - Upgrade the currently open BRL-CAD mged geometry database
       to the current geometry database	format version.

SYNOPSIS
       dbupgrade

DESCRIPTION
       dbupgrade operates on the currently open	input geometry databasefile in
       MGED. After dbupgrade is	complete, the working database will be
       upgraded	and a backup file will be saved	preserving the original
       "pre-upgrade" version of	the .g file. Keep the backup file until	it is
       clear all necessary information was successfully	preserved.

       Starting	with v5, the geometry file format is platform independent. For
       v4 .g files, however, there is a	potential problem in that the floating
       point storage format within the file is platform	dependent.
       Consequently the	safest way to upgrade a	v4 file	is to run dbupgrade on
       the file	before transferring it from the	platform on which it was
       created.	If that	system is no longer available, the dbupgrade will
       attempt to automatically	'fix' an existing (v4 format) binary database
       that was	transferred from a binary-incompatible platform.

       The older process of running g2asc(1) and asc2g(1) on a database	to
       preserve	a text version as a work-around	for platform specific binary
       files is	no longer necessary.

SEE ALSO
       mged(1),	g2asc(1), asc2g(1).

DIAGNOSTICS
       Numerous	error conditions are possible, usually due to errors in	the
       geometry	database. In the case of a binary-incompatible v4 file,	some
       errors may reflect incomplete conversion	code. Descriptive messages are
       printed on standard error (file descriptor 2).

       Example 1. Binary Incompatible v4 .g File Upgrade from MGED

	   bash4.0$ mged -c -a nu model.g
	   BRL-CAD Release 7.22.1  Geometry Editor (MGED)
	       Fri, 08 Feb 2013	15:36:52 -0500,	Compilation 0
	       user@machine:/usr/brlcad/dev-7.22.1

	   WARNING: Binary-incompatible	v4 geometry database detected.
	   Endianness flipped.	Converting to READ ONLY.
	   Opened in READ ONLY mode
	   /home/user/model.g: READ ONLY
	   Historical Model (units=in)

	   mged> dbupgrade
	   upgrade, cancel, or help? [default: help] upgrade
	   mged> q
	   bash4.0$ ls
	   model.g model.g.R4.g

AUTHOR
       BRL-CAD Team

COPYRIGHT
       This software is	Copyright (c) 2006-2013	by the United States
       Government as represented by U.S. Army Research Laboratory.

BUG REPORTS
       Reports of bugs or problems should be submitted via electronic mail to
       <devs@brlcad.org>.

BRL-CAD				  07/08/2017		       DBUPGRADE(nged)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | DIAGNOSTICS | AUTHOR | COPYRIGHT | BUG REPORTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dbupgrade&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help