127710113SBarry Smith #include <petscsys.h> 227710113SBarry Smith /*@C 327710113SBarry Smith PetscGetVersion - Gets the PETSc version information in a string. 427710113SBarry Smith 527710113SBarry Smith Input Parameter: 627710113SBarry Smith . len - length of the string 727710113SBarry Smith 827710113SBarry Smith Output Parameter: 927710113SBarry Smith . version - version string 1027710113SBarry Smith 1127710113SBarry Smith Level: developer 1227710113SBarry Smith 1327710113SBarry Smith Fortran Note: 1427710113SBarry Smith This routine is not supported in Fortran. 1527710113SBarry Smith 168cf9f3d7SBarry Smith For doing runtime checking off supported versions we recommend using PetscGetVersionNumber() instead of this routine. 178cf9f3d7SBarry Smith 185f309d01SBarry Smith .seealso: PetscGetProgramName(), PetscGetVersionNumber() 1927710113SBarry Smith 2027710113SBarry Smith @*/ 2127710113SBarry Smith 2227710113SBarry Smith PetscErrorCode PetscGetVersion(char version[], size_t len) 2327710113SBarry Smith { 248cf9f3d7SBarry Smith PetscFunctionBegin; 2527710113SBarry Smith #if (PETSC_VERSION_RELEASE == 1) 26*9566063dSJacob Faibussowitsch PetscCall(PetscSNPrintf(version,len,"Petsc Release Version %d.%d.%d, %s ",PETSC_VERSION_MAJOR,PETSC_VERSION_MINOR, PETSC_VERSION_SUBMINOR,PETSC_VERSION_DATE)); 2727710113SBarry Smith #else 28*9566063dSJacob Faibussowitsch PetscCall(PetscSNPrintf(version,len,"Petsc Development GIT revision: %s GIT Date: %s",PETSC_VERSION_GIT, PETSC_VERSION_DATE_GIT)); 2927710113SBarry Smith #endif 3027710113SBarry Smith PetscFunctionReturn(0); 3127710113SBarry Smith } 3227710113SBarry Smith 335f309d01SBarry Smith /*@C 345f309d01SBarry Smith PetscGetVersionNumber - Gets the PETSc version information from the library 355f309d01SBarry Smith 365f309d01SBarry Smith Not collective 375f309d01SBarry Smith 38d8d19677SJose E. Roman Output Parameters: 395f309d01SBarry Smith + major - the major version (optional, pass NULL if not requested) 405f309d01SBarry Smith . minor - the minor version (optional, pass NULL if not requested) 415f309d01SBarry Smith . subminor - the subminor version (patch number) (optional, pass NULL if not requested) 425f309d01SBarry Smith - release - indicates the library is from a release, not random git repository (optional, pass NULL if not requested) 435f309d01SBarry Smith 445f309d01SBarry Smith Level: developer 455f309d01SBarry Smith 4695452b02SPatrick Sanan Notes: 4795452b02SPatrick Sanan The C macros PETSC_VERSION_MAJOR, PETSC_VERSION_MINOR, PETSC_VERSION_SUBMINOR, PETSC_VERSION_RELEASE provide the information at 485f309d01SBarry Smith compile time. This can be used to confirm that the shared library being loaded at runtime has the appropriate version updates. 495f309d01SBarry Smith 508cf9f3d7SBarry Smith This function can be called before PetscInitialize() 518cf9f3d7SBarry Smith 528cf9f3d7SBarry Smith .seealso: PetscGetProgramName(), PetscGetVersion(), PetscInitialize() 535f309d01SBarry Smith 545f309d01SBarry Smith @*/ 555f309d01SBarry Smith PetscErrorCode PetscGetVersionNumber(PetscInt *major, PetscInt *minor, PetscInt *subminor,PetscInt *release) 565f309d01SBarry Smith { 575f309d01SBarry Smith if (major) *major = PETSC_VERSION_MAJOR; 585f309d01SBarry Smith if (minor) *minor = PETSC_VERSION_MINOR; 595f309d01SBarry Smith if (subminor) *subminor = PETSC_VERSION_SUBMINOR; 605f309d01SBarry Smith if (release) *release = PETSC_VERSION_RELEASE; 618cf9f3d7SBarry Smith return 0; 625f309d01SBarry Smith } 63