hpux man page for xrmcombinefiledatabase

XrmCombineFileDatabase()												  XrmCombineFileDatabase()

Name
  XrmCombineFileDatabase - combine the contents of a resource file and a resource database.

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

Arguments
  filename  Specifies the name of the resource file.

  target_db Specifies the address of the resource database with which the resource file is to be combined.

  override  Specifies whether resources from the file should override matching resources in the database.

Returns
  Zero on failure, non-zero on success.

Availability
  Release 5 and later.

Description
  XrmCombineFileDatabase()  merges  the  contents of a resource file into a database.  If the same resource 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 discarded.

  If  target_db  points to a NULL database, XrmCombineFileDatabase() creates a new database, reads the file into it and stores this new data-
  base			at		    the 		 location		    pointed		      to		   by
  target_db.  Otherwise, the database pointed to by target_db is not destroyed by the merge.

  If the file cannot be read a zero status is returned; otherwise a non-zero status is returned.

  The  file  is  parsed in the current locale.	The database entries are merged without changing values or types, regardless of the locale of
  the database, and the locale of the target database is not modified.

See Also
  XrmCombineDatabase(), XrmMergeDatabases().

Xlib - Resource Manager 												  XrmCombineFileDatabase()