Management Interface

From SambaWiki
Revision as of 14:56, 2 June 2006 by Mdietz (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


the current Samba3 implementation lacks a defined interface for managing sessions, shares, printers or parameters. Each third party management software has to parse and write the smb.conf file on it's own. Many important informations can only be gathered by parsing the output of tools like smbstatus.

Today, Samba management looks like this:


Management library / RPC Interface

Samba3 already has the concept of RPC pipes.A lot of administrative functions are already implemented. Samba4 has the libnet library which will be backported to samba3.

Samba3 management with a central library (like libnet):


Management tasks

to group the various admin functions we should work on a scope definition for the 'day to day' admin jobs. Here is a first proposal :

Process control

  • start,stop,restart services (smbd,winbindd,nmbd)
  • kill sessions

Status & Debugging

  • open sessions
  • open files (per user/per share)
  • locking infos
  • connected users
  • logs & events (read/receive)
  • health (e.g. winbind -p)
  • smbcontrol (set debug level ...)


  • global smb.conf parameters (get/set/list)
  • share mgmt (create/delete/list)
  • share acl (get/set)
  • share parameters (get/set/list)
  • printer mgmt (create/delete/list)
  • mapping of synonyms (guest only=only guest)
  • DFS roots / links
  • handling of static include files
  • variable path to config file


  • CPU
  • Memory (per user)
  • Disk
  • Network usage
  • profiling data
  • system load

User/Group Mgmt

  • List user/groups
  • Add user/groups
  • Delete user/groups
  • group memberships (list,change)