Manual Pages for UNIX Operating System command usage for man XrmCombineDatabase

XLIB FUNCTIONS                            XrmMergeDatabases(3x11)



NAME
     XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileData-
     base - merge resource databases

SYNTAX
     cc [ flag... ] file... -lX11 [ library... ]

     void XrmMergeDatabases(XrmDatabase source_db, XrmDatabase
          *target_db);

     void XrmCombineDatabase(XrmDatabase source_db, XrmDatabase
          *target_db, Bool override);

     Status XrmCombineFileDatabase(char *filename, XrmDatabase
          *target_db, Bool override);

ARGUMENTS
     source_db Specifies the resource database that is to be
               merged into the target database.

     target_db Specifies the resource database into which the
               source database is to be merged.

     filename  Specifies the resource database file name.

     override  Specifies whether source entries override target
               ones.

DESCRIPTION
     Calling the XrmMergeDatabases function is equivalent to cal-
     ling the XrmCombineDatabase function with an override argu-
     ment of True.

     The XrmCombineDatabase function merges the contents of one
     database into another.  If the same specifier is used for an
     entry in both databases, the entry in the source_db will
     replace the entry in the target_db if override is True; oth-
     erwise, the entry in source_db is discarded.  If target_db
     contains NULL, XrmCombineDatabase simply stores source_db in
     it.  Otherwise, source_db is destroyed by the merge, but the
     database pointed to by target_db is not destroyed.  The
     database entries are merged without changing values or
     types, regardless of the locales of the databases.  The
     locale of the target database is not modified.

     The XrmCombineFileDatabase function merges the contents of a
     resource file into a database.  If the same specifier is
     used for an entry in both the file and the database, the
     entry in the file will replace the entry in the database if
     override is True; otherwise, the entry in the file is dis-
     carded.  The file is parsed in the current locale.  If the
     file cannot be read, a zero status is returned; otherwise, a



X Version 11        Last change: libX11 1.3.5                   1






XLIB FUNCTIONS                            XrmMergeDatabases(3x11)



     nonzero status is returned.  If target_db contains NULL,
     XrmCombineFileDatabase creates and returns a new database to
     it.  Otherwise, the database pointed to by target_db is not
     destroyed by the merge.  The database entries are merged
     without changing values or types, regardless of the locale
     of the database.  The locale of the target database is not
     modified.

SEE ALSO
     XrmGetResource(3x11), XrmInitialize(3x11),
     XrmPutResource(3x11)
     Xlib - C Language X Interface


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libx11          |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|




























X Version 11        Last change: libX11 1.3.5                   2