SUSEAPI command line interface


suseapi <command> [options]

Commands actually indicate which operation should be performed.


This module also installs suseapi program, which allows you to easily access some of the functionality from command line. Currently following subcommands are available:

lookup-user [--by BY] [--attribs ATTRIBS] value

Lookups user information using suseapi.userinfo.

absence value

Lookups user absence information using suseapi.presence.


User configuration file
Global configration file

The program follows XDG specification, so you can adjust placement of config files by environment variables XDG_CONFIG_HOME or XDG_CONFIG_DIRS.

The configuration file is INI file, for example:

server = ldap://
base = o=Novell

servers =,


Listing absences for user mcihar:

$ suseapi absence mcihar
2015-04-06 - 2015-04-06
2015-05-01 - 2015-05-01
2015-05-08 - 2015-05-08
2015-07-06 - 2015-07-06
2015-09-28 - 2015-09-28
2015-10-28 - 2015-10-28

Listing LDAP attributes for user mcihar:

$ suseapi lookup-user --attribs COMPANY,FULLNAME,uid mcihar
  {'COMPANY': ['SUSE'], 'FULLNAME': ['Michal Cihar'], 'uid': ['mcihar']})]