This is the README file for GtkSamba-0.3.2

INTRODUCTION

GtkSamba is a GUI tool for the Configuration of the Samba, the SMB
file server on X11/Unix. It will read, edit and write /etc/smb.conf,
an alternate configuration file, or from a network. It uses the GTK
toolkit and requires Gtk+ 1.0.6 or 1.1.x. Gnome support is optional.

This is an early devlopment release, not all functionality is
implemented. It will let you edit any existing parameter from a text
entry, but without any checking.

INSTALLATION

If your in an xterm you can probably just cut and paste the following
into your command line:

./configure && make && ./src/gtksamba

and GtkSamba will be running.

Otherwise step by step:

GtkSamba now uses GNU autoconf, so after untarring the
gtksamba-<version>.tar.gz cd to gtksamba-<version> you need to run the
configure script to create the Makefile.

By default the configure script uses /usr/local as the install
prefix. If you want a different install location use the --prefix
option to the configure script. 

GtkSamba now includes optional Gnome support. If the gnome-libs are
installed on your system, the configure script will automatically
include support for it, otherwise it will not. If you have gnome-libs
and you want to force the script not to include Gnome support use the
option --without-gnome when you run the configure script.

So your configure command might look something like:

./configure  [ --prefix=/somedir ] [ --without-gnome ]

See the included file INSTALL or type './configure --help' for more
options to the configure script. After you have sucsessfully run the
script just type:

make

to build the binary and type

./src/gtksamba 

to run it. If you wanna keep it around just do the following:

make install.

TESTING IT SAFELY.

Considering that SMB services can be very critical in a production
enviroment, you may not wish to try GtkSamba for the first time on a
corporate network on a busy Monday morning. To test it safely, you can
run it as a non-root user using alternate files. Also, if you try to
write to a file that you have no write permision to, GtkSamba will
dump the output to stdout. Hence, running GtkSamba as a non-root user
from a terminal is a great way to test it out. Then when you're
confident it's safe you can try it on a real server.

TO DO

1. Create a gnome style guru for inserting an new service that will
walk the user thru the more commonly used parameters.

2. Do similar gnome style gurus to the above for the global, homes, and
printing services.

3. Implement specific support for domain controller, encrypted
passwords, etc. and create dialogs for the user to implement them
easily.

4. Generate individual GUI dialogs for some special parameters.

5. Enable managing of remote servers, mounting via SMB or NFS, or thru
SSH or RSH access.

6. Interface to smbadduser and smbpassword.

7. Write usefull comments into the config file, so you can edit it by
hand if you wish. 


BUG REPORTS, FEATURE REQUESTS AND COMMENTS:

send to perry@open-systems.com



