2 minute read

Posted 2021-04-07 - Updated 2021-05-15
Supported on Linux, Aix, MacOS

SADMIN Standard library functions

Function Call Description Return value example
check_requirements() Check/Set path of require cmd (False if some missing) True or False
date_to_epoch(epoch_time) Return date based on the Epoch time received YYYY.MM.DD HH:MM:SS
dbclose() Close SADMIN database (return (0)=Success (1)=Error) 0
dbconnect() Connect to SADMIN database (return (0)=Success (1)=Error) 0
elapse_time(end,start) Return elapse time between end (YYYY.MM.DD HH:MM:SS) & start 10:20:40
  End date MUST be greater than start date  
  Elapse time is return in a string format ‘HH:MM:SS’  
epoch_to_date(wepoch) Return date as a string based on the epoch time received YYYY.MM.DD HH:MM:SS
get_arch() Get current system architecture x86_64
get_domainname() Return current host domain name
get_epoch_time() Return current epoch time as an integer 1621263948
get_fqdn() Return fully qualified domain dame of current system
get_host_ip() Return to main IP address of current system
get_kernel_bitmode() Return kernel bit mode (32 or 64) 64
get_kernel_version() Return kernel running version 5.8.0-53-generic
get_oscodename() Return the O/S project code name focal
get_osmajorversion() Return the O/S distribution major version number 20
get_osminorversion() Return the O/S distribution minor version number 04
get_osname() Return the O/S name in uppercase UBUNTU
get_ostype() Return the O/S type (LINUX,AIX,DARWIN,…) in uppercase LINUX
get_osversion() Return the O/S distribution version number 20.04
get_packagetype()) Return the O/S main package format (rpm,deb,lpp,dmg) deb
get_release() Return SADMIN release version number 1.3.3
get_serial() Return CPU serial number BJSV942
load_config_file(sadmin_file) Load SADMIN config file & set global variables accordingly  
locate_command(cmd) Check command if available (Return cmd Path, or blank)  
oscommand(command) Execute o/s cmd received, return(returncode,stdout,stderr)  
show_version() Called when ‘-v –version’ command line argument is used  
silentremove(filename) Remove file name received - no error msg - even if failed  
start() Make sure dir. exist, init log,rch,pid, chk multiple exec abort if fail
stop(return_code) Write footer to log,rch, del pid, close db, trim log,rch  
trimfile(fname, nlines=500) Trim file received to number of lines specified(500 default) 0
writelog(msg,stype=”normal”) Write message to log File, Screen or Both (st.log_type)  


  • The “$SADMIN” environment variable must be defined and contains the root directory of the SADMIN tools (normally /opt/sadmin). It should be already done, the setup script have updated the ‘/etc/profile.d/’ and the ‘/etc/environment’ files.
  • The SADMIN configuration file, is needed and loaded in memory at the beginning of every scripts. This file should already exist and contains your SADMIN configuration and preference setting.
  • For Shell script the Shell Library is used and for Python script the Python Library is used.


Exit Code Description
0 An exit status of zero indicates success.
1 Failure is indicated by a nonzero value, typically ‘1’.


Jacques Duplessis
Any suggestions or bug report can be submitted at the support page

Copyright © 2021 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later
This is free software, you are free to change and redistribute it.
There is NO WARRANTY to the extent permitted by law.

SEE ALSO - SADMIN standard shell library - SADMIN screen oriented library - Using SADMIN Shell script template - Using SADMIN Python script template - Using SADMIN shell menu template - SADMIN Shell Library Functions Demo - SADMIN Python Library Functions Demo