Welcome
=======

Samba config is a simple tool to read, present, and change
the 'smb.conf' file via a web server/browser.

Web site:	http://legend.dhs.org/sambaconfig/

Contact:	ah@instrumentpolen.se


Features
========

 - Ability to group shares in different types
 - Copy, rename, and delete shares ([global], [homes]
    and [printers] can not be copied, deleted, or renamed though,
    this must be done by directly editing the conf file)
 - Preserves comments in the smb.conf file
 - Add / remove options from shares
 - Change option values
 - Easy to add customized forms with groups of options
 - Rough support for include files with static filenames
    (ie. an include filename like '/usr/local/samba/lib/smb.conf.%U'
    won't be seen by sambaconfig, although the 'include =' line
    will be left untouched)


Requirements
============

A running web server, and Samba.
Tested on Linux 2.0.36, apache 1.3.4 and samba 2.0.2, should
work fine elsewhere.


Include file support
====================

Use new '#include' directive in 'smb.conf' to include your
wildcard include files.
Example:

#include /usr/local/samba/lib/smb.conf.pc1
#include /usr/local/samba/lib/smb.conf.pc2
#include /usr/local/samba/lib/smb.conf.pc3
#include /usr/local/samba/lib/smb.conf.pc4
#include /usr/local/samba/lib/smb.conf.pc_ah

This will allow you to access sections within those
files too, and edit them as usual.


Generate custom form
====================

Lets you define a group of options, in one share, to view
and edit.

Look at these files:
 'config/forms.txt'	-- list of custom forms
 'config/form#'		-- form definition files

Remember to add any new form definition files in the 'install'
section of the Makefile.


Important note
==============

Always back up your samba config files before
using this software.


Support
=======

I'll probably answer emails sent to 'ah@instrumentpolen.se'.
Please email me if you get this stuff to work, it'd be nice
with some feedback / ideas / flames.
