Skip navigation links
(CGNS Documentation Home Page) (Steering Committee Charter) (Overview and Entry-Level Document) (A User's Guide to CGNS) (Standard Interface Data Structures) (SIDS-to-ADF File Mapping Manual) (SIDS-to-HDF File Mapping Manual) (Mid-Level Library) (ADF User's Guide) (CGNS Tools and Utilities)

(Introduction) (Getting Started) (Additional Information) (Troubleshooting) (Frequently Asked Questions) (Example Computer Codes) (Overview of the SIDS) (Guideline for PLOT3D Variables)

Troubleshooting

Handling Errors

The API has an extensive number of checks for errors, relating both to illegal usage of ADF as well as relating to SIDS-noncompliance. However, it is not guaranteed that the API will catch all problems prior to reaching the core level. The list of errors that can arise in the ADF core routines themselves are not listed here; they can be found in the file ADF_interface.c under "Error strings", and in the ADF User's Guide. If an error occurs, the message given by the ADF or the API routine should hopefully be descriptive enough to point to the source of the error.

Known Problems

One known problem that can occur, which is not so much a problem as it is a restriction, relates to links. If a user makes a link from one CGNS file to another, then the linked file must have write permission if the user wishes to open the linking file in CG_MODE_MODIFY or CG_MODE_WRITE mode. In other words, opening a CGNS file in CG_MODE_MODIFY or CG_MODE_WRITE mode implies that the entire CGNS hierarchy, including links (since they are transparent), is accessible in that mode.