summaryrefslogtreecommitdiffstats
path: root/ipalib/plugins/automount.py
diff options
context:
space:
mode:
authorPavel Zuna <pzuna@redhat.com>2009-06-24 15:09:26 +0200
committerRob Crittenden <rcritten@redhat.com>2009-07-02 13:33:03 -0400
commitda461998c1558b42befd0c79e12f82cceeb0d141 (patch)
tree6d788ffd64eeb8c9069f70f0bebdd51d966e4a19 /ipalib/plugins/automount.py
parent57123f2a9993be9e9ea83c1203f0670e67986de9 (diff)
downloadfreeipa-da461998c1558b42befd0c79e12f82cceeb0d141.tar.gz
freeipa-da461998c1558b42befd0c79e12f82cceeb0d141.tar.xz
freeipa-da461998c1558b42befd0c79e12f82cceeb0d141.zip
Add automount plugin.
Diffstat (limited to 'ipalib/plugins/automount.py')
-rw-r--r--ipalib/plugins/automount.py324
1 files changed, 324 insertions, 0 deletions
diff --git a/ipalib/plugins/automount.py b/ipalib/plugins/automount.py
new file mode 100644
index 000000000..246716024
--- /dev/null
+++ b/ipalib/plugins/automount.py
@@ -0,0 +1,324 @@
+# Authors:
+# Rob Crittenden <rcritten@redhat.com>
+# Pavel Zuna <pzuna@redhat.com>
+#
+# Copyright (C) 2008 Red Hat
+# see file 'COPYING' for use and warranty information
+#
+# 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; version 2 only
+#
+# 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, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+"""
+Automount
+
+RFC 2707bis http://www.padl.com/~lukeh/rfc2307bis.txt
+
+A few notes on automount:
+- It was a design decision to not support different maps by location
+- The default parent when adding an indirect map is auto.master
+- This uses the short format for automount maps instead of the
+ URL format. Support for ldap as a map source in nsswitch.conf was added
+ in autofs version 4.1.3-197. Any version prior to that is not expected
+ to work.
+
+As an example, the following automount files:
+
+auto.master:
+/- auto.direct
+/mnt auto.mnt
+
+auto.mnt:
+stuff -ro,soft,rsize=8192,wsize=8192 nfs.example.com:/vol/archive/stuff
+
+are equivalent to the following LDAP entries:
+
+# auto.master, automount, example.com
+dn: automountmapname=auto.master,cn=automount,dc=example,dc=com
+objectClass: automountMap
+objectClass: top
+automountMapName: auto.master
+
+# auto.direct, automount, example.com
+dn: automountmapname=auto.direct,cn=automount,dc=example,dc=com
+objectClass: automountMap
+objectClass: top
+automountMapName: auto.direct
+
+# /-, auto.master, automount, example.com
+dn: automountkey=/-,automountmapname=auto.master,cn=automount,dc=example,dc=co
+ m
+objectClass: automount
+objectClass: top
+automountKey: /-
+automountInformation: auto.direct
+
+# auto.mnt, automount, example.com
+dn: automountmapname=auto.mnt,cn=automount,dc=example,dc=com
+objectClass: automountMap
+objectClass: top
+automountMapName: auto.mnt
+
+# /mnt, auto.master, automount, example.com
+dn: automountkey=/mnt,automountmapname=auto.master,cn=automount,dc=example,dc=
+ com
+objectClass: automount
+objectClass: top
+automountKey: /mnt
+automountInformation: auto.mnt
+
+# stuff, auto.mnt, automount, example.com
+dn: automountkey=stuff,automountmapname=auto.mnt,cn=automount,dc=example,dc=com
+objectClass: automount
+objectClass: top
+automountKey: stuff
+automountInformation: -ro,soft,rsize=8192,wsize=8192 nfs.example.com:/vol/arch
+ ive/stuff
+
+"""
+from ipalib import api, errors
+from ipalib import Object, Command
+from ipalib import Flag, Str
+from ipalib.plugins.baseldap import *
+
+_map_container_dn = api.env.container_automount
+
+_map_default_attributes = ['automountmapname', 'description']
+_key_default_attributes = [
+ 'automountkey', 'automountinformation', 'description'
+]
+
+
+class automountmap(LDAPObject):
+ """
+ Automount map object.
+ """
+ container_dn = _map_container_dn
+ object_name = 'automount map'
+ object_name_plural = 'automount maps'
+ object_class = ['automountmap']
+ default_attributes = _map_default_attributes
+
+ takes_params = (
+ Str('automountmapname',
+ cli_name='name',
+ primary_key=True,
+ doc='automount map name',
+ ),
+ Str('description?',
+ cli_name='desc',
+ doc='description',
+ ),
+ )
+
+api.register(automountmap)
+
+
+class automountmap_add(LDAPCreate):
+ """
+ Create new automount map.
+ """
+
+api.register(automountmap_add)
+
+
+class automountmap_del(LDAPDelete):
+ """
+ Delete automount map.
+ """
+ def post_callback(self, ldap, dn, *keys, **options):
+ # delete optional parental connection (direct maps may not have this)
+ try:
+ (dn_, entry_attrs) = ldap.find_entry_by_attr(
+ 'automountinformation', keys[0], 'automount',
+ base_dn=self.obj.container_dn
+ )
+ ldap.delete_entry(dn_)
+ except errors.NotFound:
+ pass
+ return True
+
+api.register(automountmap_del)
+
+
+class automountmap_mod(LDAPUpdate):
+ """
+ Modify automount map.
+ """
+
+api.register(automountmap_mod)
+
+
+class automountmap_find(LDAPSearch):
+ """
+ Search for automount maps.
+ """
+
+api.register(automountmap_find)
+
+
+class automountmap_show(LDAPRetrieve):
+ """
+ Display automount map.
+ """
+
+api.register(automountmap_show)
+
+
+class automountkey(LDAPObject):
+ """
+ Automount key object.
+ """
+ container_dn = _map_container_dn
+ object_name = 'automount key'
+ object_name_plural = 'automount keys'
+ parent_object_name = 'map'
+ object_class = ['automount']
+ default_attributes = _key_default_attributes
+
+ takes_params = (
+ Str('automountmapname',
+ cli_name='map',
+ doc='name of automount map grouping related keys',
+ parent_key=True,
+ ),
+ Str('automountkey',
+ cli_name='key',
+ doc='key name',
+ primary_key=True,
+ ),
+ Str('automountinformation',
+ cli_name='info',
+ doc='mount information',
+ ),
+ Str('description?',
+ cli_name='desc',
+ doc='description',
+ ),
+ )
+
+api.register(automountkey)
+
+
+class automountkey_add(LDAPCreate):
+ """
+ Create new automount key.
+ """
+
+api.register(automountkey_add)
+
+
+class automountkey_del(LDAPDelete):
+ """
+ Delete automount key.
+ """
+
+api.register(automountkey_del)
+
+
+class automountkey_mod(LDAPUpdate):
+ """
+ Modify automount key.
+ """
+
+api.register(automountkey_mod)
+
+
+class automountkey_find(LDAPSearch):
+ """
+ Modify automount key.
+ """
+
+api.register(automountkey_find)
+
+
+class automountkey_show(LDAPRetrieve):
+ """
+ Display automount key.
+ """
+
+api.register(automountkey_show)
+
+
+class automountmap_add_indirect(LDAPCreate):
+ """
+ Create new indirect mount point.
+ """
+ takes_options = (
+ Str('key',
+ cli_name='key',
+ doc='key name (mount point)',
+ ),
+ Str('parentmap?',
+ cli_name='parentmap',
+ doc='name of parent automount map to connect this map to',
+ default=u'auto.master',
+ autofill=True,
+ ),
+ )
+
+ def execute(self, map, **options):
+ self.api.Command['automountmap_add'](map, **options)
+ options['automountinformation'] = map
+ return self.api.Command['automountkey_add'](
+ options['parentmap'], options['key'], **options
+ )
+
+api.register(automountmap_add_indirect)
+
+
+class automount_tofiles(Command):
+ """
+ Generate the automount maps as they would be in the filesystem.
+ """
+ def execute(self):
+ ldap = self.api.Backend.ldap2
+
+ maps = []
+ (maps, truncated) = self.api.Command['automountkey-find'](
+ automountmapname=u'auto.master'
+ )
+ # TODO: handle truncated results
+ # it will probably require direct calls to the ldap backend
+
+ keys = {}
+ for (dn, m) in maps:
+ info = m['automountinformation'][0]
+ (keys[info], truncated) = self.api.Command['automountkey_find'](
+ automountmapname=info
+ )
+ # TODO: handle truncated results
+
+ return (maps, keys)
+
+ def output_for_cli(self, textui, result, **options):
+ (maps, keys) = result
+
+ textui.print_plain('/etc/auto.master:')
+ for (dn, m) in maps:
+ textui.print_plain(
+ '%s\t/etc/%s' % (
+ m['automountkey'][0], m['automountinformation'][0]
+ )
+ )
+ for (dn, m) in maps:
+ info = m['automountinformation'][0]
+ textui.print_plain('---------------------------')
+ textui.print_plain('/etc/%s:' % info)
+ for (dn, k) in keys[info]:
+ textui.print_plain(
+ '%s\t%s' % (
+ k['automountkey'][0], k['automountinformation'][0]
+ )
+ )
+
+api.register(automount_tofiles)
+