diet-fmd -
utility daemon for file system management

Gael Le Mahec

2010/02/02

Version 1.1

diet-fmd can manage a file system on a machine. This command takes in argument the name of the machine where the file system will be manage, a user-table and a grp-table declaring the mapping rules for the users and the groups, but also a configuration file, and a temporary directory for temporary files.

Table of Contents

Synopsis

diet-fmd [--config diet_config_file] [--host machine] [--user-table user_table_file] [--grp-table grp_table_file] [--tmp-dir temporary_directory]

Description

diet-fmd uses the configuration file diet_config_file defined with the --config option to be able for a client program to interact with the local file system. If the --config option is not set, diet-fmd will use the configuration file defined by dietconfig in /etc/DIET/diet-fmd.cfg (which is the default location of the file). If this file does not exist, the diet_config_file could also be defined with the DFMS_DIET_CONFIG environment variable.

The host is by default the system hostname. This can be override by the --host option on the command line. If the --host option is not set, diet-fmd will use the host name defined by hostname option in /etc/DIET/diet-fmd.cfg (which is the default location of the file). If this file does not exist, the host name could also be defined with the DFMS_HOST_NAME environment variable.

diet-fmd uses the user_table_file to map the input users to the local users. If the --user-table option is not set, diet-fmd will use the user-table value defined by the usertable option in /etc/DIET/diet-fmd.cfg (which is the default location of the file). If this file does not exist, the user-table could also be defined with the DFMS_USER_TABLE environment variable.

diet-fmd uses the grp_table_file to map the input groups to the local groups. If the --grp-table option is not set, diet-fmd will use the grp-table value defined by the grouptable option in /etc/DIET/diet-fmd.cfg (which is the default location of the file). If this file does not exist, the grp-table could also be defined with the DFMS_GRP_TABLE environment variable.

diet-fmd uses the temporary_directory to store temporarily files when they are transferred. If the --batch option is not set, diet-fmd will use the tmp-dir value defined by the tmpdirectory option in /etc/DIET/diet-fmd.cfg (which is the default location of the file). If this file does not exist, the temporary_directory could also be defined with the DFMS_BATCH_NAME environment variable.

[--config diet_config_file]
Configuration file used by diet-fmd to be able for a client to interact with the file system of machine.
--host machine
Name of the machine where the file system is located.
--tmp-dir temporary_directory
Path to a temporary directory.
--user-table user_table_file
File defining how to map input users to local users.
--grp-table grp_table_file
File defining how to map input groups to local groups.
-h|--help
Some help about diet-fmd.

Files and variables

Files

/etc/DIET/diet-fmd.cfg
Default configuration file for diet-fmd that can store daemon configuration options.
user_table_file
The user-table file
grp_table_file
The grp-table file

diet-fmd.cfg configuration file

The diet-fmd.cfg file can store all the options of diet-fmd with the following options:

dietconfig
path to the DIET configuration file
usertable
path to the user-table file
grouptable
path to the grp-table file
hostname
host name
tmpdirectory
temporary directory

It could look like this:

dietconfig = /etc/DIET/SeD.cfg
usertable = /etc/DIET/user-table.txt
grouptable = /etc/DIET/group-table.txt
hostname = foo
tmpdirectory = /tmp/bar

Variables

Some variables could be use to simplify the command of the diet-fmd:
DFMS_DIET_CONFIG
path to the DIET configuration file
DFMS_USER_TABLE
path to the user-table file
DFMS_GRP_TABLE
path to the grp-table file
DFMS_HOST_NAME
host name
DFMS_TMP_DIR
temporary directory

Example

How to launch the diet-fmd daemon with all the options on the command line? Let's see with the /tmp/bar temporary directory on the foo machine:

diet-fmd --config path_to_the_configuration_file --user-table /etc/DIET/user-table.txt --grp-table /etc/DIET/grp-table.txt --host foo --tmp-dir /tmp/bar

Now, suppose that we have the a well-defined diet-fmd.cfg file defined in the /etc/DIET directory (or elsewhere from the moment that the compilation has been do we the right path) that looks like to the one described above. We could then directly call the diet-fmd program like this:

diet-fmd

See also

diet-fmd(1), diet-chgrp(1), diet-chmod(1), diet-cp(1), diet-head(1), diet-ls(1), diet-mkdir(1), diet-mv(1), diet-rm(1), diet-rmdir(1), diet-tail(1), diet-status(1), diet-agent, omniNames.

Prerequisites

DIET
diet-fmd requires a DIET installation with version >= 2.3.

Version

Version: 1.1 of 2010/02/02.

License et Copyright

Copyright
© 2010, GRAAL, INRIA Rhône-Alpes, 46 allée d'Italie, 69364 Lyon cedex 07, France tech@sysfera.com

Licence
diet-fmd Copyright (C) 2010, GRAAL, INRIA Rhône-Alpes - all rights reserved.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see .

Misc
If you find that software interesting, or if you find a bug, please send us a mail : tech@sysfera.com with the description of the problem, the version of the program and/or any information that could help us fixing it.

Author

GRAAL, INRIA Rhône-Alpes
46 allée d'Italie
69364 Lyon cedex 07, FRANCE
Email: tech@sysfera.com
WWW: http://www.sysfera.com.