xref: /petsc/src/sys/objects/version.c (revision 9566063d113dddea24716c546802770db7481bc0)
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