docs-xml/wscript_build

   1 #!/usr/bin/env python
   2 from samba_utils import save_file
   3 import os
   4 manpages='''
   5          manpages/cifsdd.8
   6          manpages/dbwrap_tool.1
   7          manpages/eventlogadm.8
   8          manpages/idmap_ad.8
   9          manpages/idmap_autorid.8
  10          manpages/idmap_hash.8
  11          manpages/idmap_ldap.8
  12          manpages/idmap_nss.8
  13          manpages/idmap_rfc2307.8
  14          manpages/idmap_rid.8
  15          manpages/idmap_script.8
  16          manpages/idmap_tdb.8
  17          manpages/idmap_tdb2.8
  18          manpages/libsmbclient.7
  19          manpages/lmhosts.5
  20          manpages/log2pcap.1
  21          manpages/mdsearch.1
  22          manpages/mvxattr.1
  23          manpages/net.8
  24          manpages/nmbd.8
  25          manpages/nmblookup.1
  26          manpages/ntlm_auth.1
  27          manpages/pdbedit.8
  28          manpages/profiles.1
  29          manpages/rpcclient.1
  30          manpages/samba-dcerpcd.8
  31          manpages/samba-regedit.8
  32          manpages/samba-tool.8
  33          manpages/samba.7
  34          manpages/samba.8
  35          manpages/samba_downgrade_db.8
  36          manpages/sharesec.1
  37          manpages/smbcacls.1
  38          manpages/smbclient.1
  39          manpages/smbcontrol.1
  40          manpages/smbcquotas.1
  41          manpages/smbd.8
  42          manpages/smbget.1
  43          manpages/smbpasswd.5
  44          manpages/smbpasswd.8
  45          manpages/smbspool_krb5_wrapper.8
  46          manpages/smbspool.8
  47          manpages/samba-bgqd.8
  48          manpages/smbstatus.1
  49          manpages/smbtar.1
  50          manpages/smbtree.1
  51          manpages/testparm.1
  52          manpages/traffic_learner.7
  53          manpages/traffic_replay.7
  54          manpages/wbinfo.1
  55          manpages/winbindd.8
  56          manpages/samba-log-parser.1
  57          manpages/wspsearch.1
  58          '''
  59
  60 pam_winbind_manpages = '''
  61                        manpages/pam_winbind.8
  62                        manpages/pam_winbind.conf.5
  63                        '''
  64
  65 krb5_locator_manpages = 'manpages/winbind_krb5_locator.8'
  66 krb5_localauth_manpages = 'manpages/winbind_krb5_localauth.8'
  67
  68 winexe_manpages = 'manpages/winexe.1'
  69
  70 vfs_module_manpages = ['vfs_acl_tdb',
  71                        'vfs_acl_xattr',
  72                        'vfs_aio_fork',
  73                        'vfs_aio_pthread',
  74                        'vfs_io_uring',
  75                        'vfs_audit',
  76                        'vfs_btrfs',
  77                        'vfs_cacheprime',
  78                        'vfs_cap',
  79                        'vfs_catia',
  80                        'vfs_ceph',
  81                        'vfs_ceph_new',
  82                        'vfs_ceph_snapshots',
  83                        'vfs_commit',
  84                        'vfs_crossrename',
  85                        'vfs_default_quota',
  86                        'vfs_dirsort',
  87                        'vfs_expand_msdfs',
  88                        'vfs_extd_audit',
  89                        'vfs_fake_perms',
  90                        'vfs_fileid',
  91                        'vfs_fruit',
  92                        'vfs_full_audit',
  93                        'vfs_glusterfs',
  94                        'vfs_glusterfs_fuse',
  95                        'vfs_gpfs',
  96                        'vfs_linux_xfs_sgid',
  97                        'vfs_media_harmony',
  98                        'vfs_nfs4acl_xattr',
  99                        'vfs_offline',
 100                        'vfs_prealloc',
 101                        'vfs_preopen',
 102                        'vfs_readahead',
 103                        'vfs_readonly',
 104                        'vfs_recycle',
 105                        'vfs_shadow_copy',
 106                        'vfs_shadow_copy2',
 107                        'vfs_shell_snap',
 108                        'vfs_snapper',
 109                        'vfs_streams_depot',
 110                        'vfs_streams_xattr',
 111                        'vfs_syncops',
 112                        'vfs_time_audit',
 113                        'vfs_tsmsm',
 114                        'vfs_unityed_media',
 115                        'vfs_virusfilter',
 116                        'vfs_widelinks',
 117                        'vfs_worm',
 118                        'vfs_xattr_tdb',
 119                        'vfs_zfsacl' ]
 120
 121 def generate_path_entity_list():
 122     entities = bld.pathconfig_entities()
 123
 124     # We need this if we build with Heimdal as we can't easily make
 125     # the whole option go away
 126     mit_kdc_path = '""'
 127     # The MIT krb5kdc path is set if we build with MIT Kerberos
 128     if bld.CONFIG_SET('MIT_KDC_PATH'):
 129         mit_kdc_path = bld.CONFIG_GET('MIT_KDC_PATH')
 130
 131     t = "\n".join(entities) +\
 132         "\n" +\
 133         "<!ENTITY pathconfig.MITKDCPATH   " + mit_kdc_path + ">\n" +\
 134         "\n"
 135     return t
 136
 137 def smbdotconf_generate_parameter_list_file(task):
 138     parameter_all = task.outputs[0].bldpath(task.env)
 139     articles = task.inputs
 140
 141     t = "<!DOCTYPE section [\n" +\
 142         generate_path_entity_list() + \
 143         "]>\n" +\
 144         "<section>\n" +\
 145         "".join(art.read() for art in articles) +\
 146         "</section>\n"
 147
 148
 149     save_file(parameter_all, t , create_dir=True)
 150     return 0
 151
 152 # Since nothing really forces sorting in glob, we have to sort by file name
 153 # POSIX file systems aren't required to return sorted content but we want
 154 # smb.conf parameters to be sorted alphabetically
 155 parameter_all = 'smbdotconf/parameters.all.xml'
 156 sources = bld.path.ant_glob("smbdotconf/**/*.xml", flat=False, excl=parameter_all)
 157 articles = " ".join(sorted([x.path_from(bld.path) for x in sources],
 158                            key=lambda m: m.split(os.sep)[-1]))
 159
 160 bld.SAMBA_GENERATOR(parameter_all,
 161                     source=articles,
 162                     target=parameter_all,
 163                     rule=smbdotconf_generate_parameter_list_file)
 164
 165 def generate_path_entity_file(task):
 166     path_entities_file = task.outputs[0].bldpath(task.env)
 167
 168     save_file(path_entities_file,
 169               generate_path_entity_list(),
 170               create_dir=True)
 171     return 0
 172
 173 path_entities = 'build/DTD/samba.build.pathconfig'
 174
 175 bld.SAMBA_GENERATOR(path_entities,
 176                     source=articles,
 177                     target=path_entities,
 178                     rule=generate_path_entity_file,
 179                     dep_vars=bld.dynconfig_varnames())
 180
 181
 182 def SMBDOTCONF_MANPAGE(bld, target):
 183     ''' assemble and build smb.conf.5 manual page'''
 184     bld.SAMBAMANPAGES(target, parameter_all)
 185
 186 if ('XSLTPROC_MANPAGES' in bld.env and bld.env['XSLTPROC_MANPAGES']):
 187
 188     SMBDOTCONF_MANPAGE(bld, 'manpages/smb.conf.5')
 189     bld.SAMBAMANPAGES(manpages)
 190
 191     if bld.CONFIG_SET('WITH_PAM_MODULES') and bld.CONFIG_SET('HAVE_PAM_START'):
 192         bld.SAMBAMANPAGES(pam_winbind_manpages)
 193
 194     if bld.CONFIG_SET('HAVE_KRB5_LOCATE_PLUGIN_H'):
 195         bld.SAMBAMANPAGES(krb5_locator_manpages)
 196
 197     if bld.CONFIG_SET('HAVE_KRB5_LOCALAUTH_PLUGIN_H'):
 198         bld.SAMBAMANPAGES(krb5_localauth_manpages)
 199
 200     if conf.env.build_winexe == True:
 201         bld.SAMBAMANPAGES(winexe_manpages)
 202
 203     if bld.CONFIG_SET('ENABLE_SELFTEST'):
 204         bld.SAMBAMANPAGES('manpages/vfstest.1')
 205
 206     for manpage in vfs_module_manpages:
 207         if bld.SAMBA3_IS_ENABLED_MODULE(manpage):
 208             bld.SAMBAMANPAGES('manpages/%s.8' % manpage)