activesambaldap 0.0.6 → 0.0.7

data/README.ja

@@ -1,14 +1,12 @@
-# -*- rd -*-
-
 = README.ja
 
-$Id: README.ja 145 2008-06-14 14:30:20Z kou $
+$Id: README.ja 165 2009-07-17 22:35:02Z kou $
 
 == 名前
 
 ActiveSambaLdap
 
-== なにこれ？
+== 説明
 
 ActiveSambaLdapはSamba用LDAPエントリを管理するための
 ActiveRecord風なライブラリです．また，smbldap-toolsのような
@@ -16,36 +14,35 @@ ActiveRecord風なライブラリです．また，smbldap-toolsのような
 
 == 作者
 
-Kouhei Sutou <kou@cozmixng.org>
+Kouhei Sutou <tt><kou@clear-code.com></tt>
 
 == ライセンス
 
 Ruby's.
 
+== 依存ライブラリ
+
+* ActiveLdap >= 1.1.0
+
+== インストール
+
+  % sudo gem install activesambaldap
+
 == メーリングリスト
 
 asl-devel-ja@rubyforge.org
 
-((<URL:http://rubyforge.org/mailman/listinfo/asl-devel-ja/>))
+http://rubyforge.org/mailman/listinfo/asl-devel-ja/
 
 == リファレンスマニュアル
 
-((<URL:http://asl.rubyforge.org/activesambaldap/>))
-
-== 依存ライブラリ
-
-  * ActiveLdap >= 1.0.1
+http://asl.rubyforge.org/activesambaldap/
 
 == 使用法
 
 === Railsと使う
 
-まず，Rails用プラグインをインストールします．以下のURLは
-trunk用ですので，環境にあわせて変更してください．
-
-  % script/plugin install svn://rubyforge.org/var/svn/asl/trunk/rails/plugin/active_samba_ldap
-
-次に，Rails用ActiveSambaLdap環境を構築します．
+Rails用ActiveSambaLdap環境を構築します．
 
   % script/generate scaffold_active_samba_ldap
 
@@ -90,10 +87,10 @@ asl-populateを使うとこうなります．
 ファイルで上書きされます．上記の例だと，以下の順序で読み込ま
 れていきます．
 
-  * /etc/activesambaldap/config.yaml
-  * /etc/activesambaldap/bind.yaml
-  * /home/kou/.activesambaldap.conf
-  * /home/kou/.activesambaldap.bind
+* /etc/activesambaldap/config.yaml
+* /etc/activesambaldap/bind.yaml
+* /home/kou/.activesambaldap.conf
+* /home/kou/.activesambaldap.bind
 
 config.yamlや*.confの後にbind.yamlや*.bindを読み込んでいるの
 はセキュリティ上の配慮です．ホスト名などの見られてもよい情報
@@ -146,108 +143,137 @@ sidを設定しておかないと，毎回net getlocalsidをするため，効
 
 設定可能なオプションは以下の通りです．
 
-: base
-   ActiveLdap::Base.establish_connectionのオプションと同じ．
-: host
-   ActiveLdap::Base.establish_connectionのオプションと同じ．
-: port
-   ActiveLdap::Base.establish_connectionのオプションと同じ．
-: scope
-   ActiveLdap::Base.establish_connectionのオプションと同じ．
-: bind_dn
-   ActiveLdap::Base.establish_connectionのオプションと同じ．
-: password
-   ActiveLdap::Base.establish_connectionのオプションと同じ．
-: method
-   ActiveLdap::Base.establish_connectionのオプションと同じ．
-: allow_anonymous
-   ActiveLdap::Base.establish_connectionのオプションと同じ．
-
-: sid
+[_base_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_host_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_port_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_scope_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_bind_dn_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_password_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_method_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_allow_anonymous_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+
+[_sid_]
    SambaサーバのSID(Security Identifier)．
-: smb_conf
+[_smb_conf_]
    Sambaの設定ファイルsmb.confがあるパス．
-: samba_domain
+[_samba_domain_]
    Sambaサーバのドメイン
-: samba_netbios_name
+[_samba_netbios_name_]
    SambaサーバのNetBIOS名
 
-: password_hash_type
+[_password_hash_type_]
    LDAP上のパスワードをハッシュ化する時に使用するアルゴリズ
-   ム．指定できるのは:crypt, :md5, :smd5, :sha, :sshaで，デ
-   フォルトは:sshaです．
+   ム．指定できるの
+   は+:crypt+, +:md5+, +:smd5+, +:sha+, +:ssha+です。
 
    LDAP上のパスワードはSambaの認証時ではなく，UNIX上のユーザ
    の認証時に利用されます．
 
-: users_suffix
+   デフォルト: +:ssha+
+
+[_users_suffix_]
    LDAP上のユーザエントリを格納するツリー．baseからの相対パ
-   スを指定する．例: ou=Users
-: groups_suffix
+   スを指定する．
+
+   例: <tt>"ou=Users"</tt>
+
+[_groups_suffix_]
    LDAP上のグループエントリを格納するツリー．baseからの相対パ
-   スを指定する．例: ou=Groups
-: computers_suffix
+   スを指定する．
+
+   例: <tt>"ou=Groups"</tt>
+
+[_computers_suffix_]
    LDAP上のコンピュータエントリを格納するツリー．baseからの相対パ
-   スを指定する．例: ou=Computers
-: idmap_suffix
+   スを指定する．
+
+   例: <tt>"ou=Computers"</tt>
+
+[_idmap_suffix_]
    LDAP上のidmapエントリを格納するツリー．baseからの相対パ
-   スを指定する．例: ou=Idmap
+   スを指定する．
 
-: start_uid
+   例: <tt>"ou=Idmap"</tt>
+
+[_start_uid_]
    新しいユーザを作ったときに，はじめに使用するUID(User
-   Identifier)．以降のUIDは1ずつ増えていく．デフォルトは
-   10000．
+   Identifier)．以降のUIDは1ずつ増えていく．
+
+   デフォルト: +10000+
 
-: start_gid
+[_start_gid_]
    新しいユーザを作ったときに，はじめに使用するGID(Group
-   Identifier)．以降のGIDは1ずつ増えていく．デフォルトは
-   10000．
+   Identifier)．以降のGIDは1ずつ増えていく．
 
-: user_login_shell
-   新しく作成したユーザのログインシェル．デフォルトは
-   /bin/false．
-: user_home_directory
+   デフォルト: +10000+
+
+[_user_login_shell_]
+   新しく作成したユーザのログインシェル．
+
+   デフォルト: <tt>"/bin/false"</tt>
+
+[_user_home_directory_]
    新しく作成したユーザのホームディレクトリ．%Uはユーザ名に
-   置換される．デフォルトは/home/%U．
-: user_home_directory_mode
+   置換される．
+
+   デフォルト: <tt>"/home/%U"</tt>
+
+[_user_home_directory_mode_]
    ユーザのホームディレクトリを作成する際に設定するパーミッ
-   ション用のモード．デフォルトは0755（8進数）．
+   ション用のモード．
+
+   デフォルト: +0755+（8進数）
 
-: user_gecos
+[_user_gecos_]
    ユーザのGECOSフィールドの値．%Uはユーザ名に置換される．
 
-: user_home_unc
+[_user_home_unc_]
    Windowsから見たときのユーザのホームへのパス．
    UNC(Universal Naming Convention)で記述する．%Uはユーザ名
-   に置換される．デフォルトは\\SambaサーバのNetBIOS名\%U．
+   に置換される．
 
-: user_profile
+   デフォルト: <tt>"\\\\SambaサーバのNetBIOS名\\%U"</tt>
+
+[_user_profile_]
    ユーザプロファイルへのパス．
    UNC(Universal Naming Convention)で記述する．%Uはユーザ名
-   に置換される．デフォルトは\\SambaサーバのNetBIOS名\profiles\%U．
+   に置換される．
+
+   デフォルト: <tt>"\\\\SambaサーバのNetBIOS名\\profiles\\%U"</tt>
 
-: user_home_drive
-   ユーザのホームを割り当てるドライブ名．デフォルトはH:．
+[_user_home_drive_]
+   ユーザのホームを割り当てるドライブ名．
 
-: user_logon_script
+   デフォルト: <tt>"H:"</tt>
+
+[_user_logon_script_]
    ユーザがログオンしたときに実行するスクリプトファイル名．
-   デフォルトはlogon.bat．
 
-# : mail_domain
+   デフォルト: <tt>"logon.bat"</tt>
 
-: skeleton_directory
+[_skeleton_directory_]
    ユーザのホームディレクトリを作成する時に雛型とするディレ
-   クトリ．デフォルトは/etc/skel．
+   クトリ．
+
+   デフォルト: <tt>"/etc/skel"</tt>
+
+[_default_user_gid_]
+   デフォルトでユーザが所属するグループ．
 
-: default_user_gid
-   デフォルトでユーザが所属するグループ．デフォルトはDomain
-   Usersグループ．
+   デフォルト: <tt>"Domain Users"</tt>グループ
 
-: default_computer_gid
-   デフォルトでコンピュータが所属するグループ．デフォルトは
-   Domain Computersグループ．
+[_default_computer_gid_]
+   デフォルトでコンピュータが所属するグループ．
 
-# : default_max_password_age
+   デフォルト: <tt>"Domain Computers"</tt>グループ
 
 ==== 初期化
 
@@ -258,7 +284,7 @@ asl-populateを起動してLDAPサーバに基本的なエントリを追加し
   % sudo asl-populate
 
 もし，root権限が無くても実行できるのであれば以下のようにする
-とよいでしょう((-root権限チェックは必要ないかもしれない-))．
+とよいでしょう．（root権限チェックは必要ないかもしれない）
 
   % fakeroot asl-populate
 
@@ -270,10 +296,10 @@ asl-purge, asl-passwordを使って管理してください．各コマンド
 
 ==== smb.confの設定
 
-((<Srvtools|URL:http://support.microsoft.com/kb/173673/>))を
-使ってWindowsからユーザ管理を行いたい場合は，また，Sambaをド
-メインコントローラとして動作させたい場合は，以下のように
-smb.confを設定します．ここでは，asl-samba-*を使います．
+Srvtools[http://support.microsoft.com/kb/173673/]を使って
+Windowsからユーザ管理を行いたい場合は，また，Sambaをドメイン
+コントローラとして動作させたい場合は，以下のようにsmb.confを
+設定します．ここでは，asl-samba-*を使います．
 
 （ドメインコントローラとして動作させるけど，Srvtools でユー
 ザ管理を行わない場合はadd machine script以外のなんとかscript
@@ -314,16 +340,17 @@ LDAP管理ユーザのパスワードを設定しておく必要があります
 もし、asl-populateした後なのに上記のコマンドでひとつもグルー
 プがでない場合は以下のことを確認してください。
 
-  * samba.schemaが古くないか
+* samba.schemaが古くないか
 
-    sambaSIDのエントリに以下の設定がない場合は古い
-    samba.schemaである可能性があります。最新のものに更新して
-    ください。
+  sambaSIDのエントリに以下の設定がない場合は古い
+  samba.schemaである可能性があります。最新のものに更新して
+  ください。
 
-      SUBSTR caseExactIA5SubstringsMatch
+    SUBSTR caseExactIA5SubstringsMatch
 
 == 感謝
 
-  * Henrik Krög: バグを報告してくれました。
-  * Olivier DIRRENBERGER: バグを報告してくれました。
-  * Francesco Malvezzi: バグを報告してくれました。
+* Henrik Krög: バグを報告してくれました。
+* Olivier DIRRENBERGER: バグを報告してくれました。
+* Francesco Malvezzi: バグを報告してくれました。
+* Kazuhiro NISHIYAMA: バグを報告してくれました。

data/Rakefile

@@ -43,19 +43,6 @@ def cleanup_white_space(entry)
   entry.gsub(/(\A\n+|\n+\z)/, '') + "\n"
 end
 
-class Hoe
-  attr_accessor :full_name
-
-  alias_method :announcement_original, :announcement
-  def announcement
-    name_orig = name
-    self.name = full_name
-    announcement_original
-  ensure
-    self_name = name_orig
-  end
-end
-
 # For Hoe's no user friendly default behavior. :<
 File.open("README.txt", "w") {|file| file << "= Dummy README\n== XXX\n"}
 FileUtils.cp("NEWS.en", "History.txt")
@@ -65,22 +52,22 @@ at_exit do
 end
 
 ENV["VERSION"] = ActiveSambaLdap::VERSION
-project = Hoe.new("activesambaldap", ActiveSambaLdap::VERSION) do |p|
-  p.rubyforge_name = "asl"
-  p.full_name = "ActiveSambaLdap"
-  p.summary = "Samba+LDAP administration tools"
-  p.extra_deps << ["activeldap", required_active_ldap_version]
-  p.email = "kou@cozmixng.org"
-  p.author = "Kouhei Sutou"
-  p.url = "http://asl.rubyforge.org/"
-  p.rdoc_pattern = /^(lib|bin)|txt$|\.(en|ja)$/
+project = Hoe.spec("activesambaldap") do
+  self.version = ActiveSambaLdap::VERSION
+  self.rubyforge_name = "asl"
+  # self.name = "ActiveSambaLdap"
+  self.summary = "Samba+LDAP administration tools"
+  self.extra_deps << ["activeldap", required_active_ldap_version]
+  self.email = ["kou@clear-code.com"]
+  self.author = "Kouhei Sutou"
+  self.url = "http://asl.rubyforge.org/"
 
   news_of_current_release = File.read("NEWS.en").split(/^==\s.*$/)[1]
-  p.changes = cleanup_white_space(news_of_current_release)
+  self.changes = cleanup_white_space(news_of_current_release)
 
   entries = File.read("README.en").split(/^==\s(.*)$/)
-  whats_this = cleanup_white_space(entries[entries.index("What\'s this?") + 1])
-  p.summary, p.description, = whats_this.split(/\n\n+/, 3)
+  whats_this = cleanup_white_space(entries[entries.index("Description") + 1])
+  self.summary, self.description, = whats_this.split(/\n\n+/, 3)
 end
 
 
@@ -93,9 +80,9 @@ end
 rdoc_task.main = rdoc_main
 rdoc_task.options.delete("-d")
 rdoc_task.options << "--charset=UTF-8"
-rdoc_task.template = "kilmer"
-rdoc_task.rdoc_files -= project.bin_files
-rdoc_task.rdoc_files += project.bin_files.collect {|x| "#{x}.help"}
+rdoc_task.rdoc_files -= project.spec.executables
+rdoc_task.rdoc_files += project.spec.executables.collect {|x| "bin/#{x}.help"}
+rdoc_task.rdoc_files += project.spec.files.find_all {|x| /\.(en|ja)\z/ =~ x}
 rdoc_task.rdoc_files.reject! {|file| /\Atest-unit\// =~ file}
 
 rdoc_options = rdoc_task.option_list
@@ -104,8 +91,8 @@ rdoc_options[output_option_index, 2] = nil
 project.spec.rdoc_options = rdoc_options
 project.spec.extra_rdoc_files = rdoc_task.rdoc_files
 
-
-project.bin_files.each do |bin|
+project.spec.executables.each do |bin|
+  bin = "bin/#{bin}"
   bin_help = "#{bin}.help"
   File.open(bin_help, "w") do |f|
     lang = ENV["LANG"]
@@ -118,6 +105,18 @@ project.bin_files.each do |bin|
   end
 end
 
+task :docs do
+  css_file = "doc/rdoc.css"
+  css = File.read(css_file)
+  reset_spacing = Regexp.escape("*{ padding: 0; margin: 0; }")
+  customized_css = css.sub(/#{reset_spacing}/, '')
+  if css != customized_css
+    File.open(css_file, "w") do |output|
+      output.print(customized_css)
+    end
+  end
+end
+
 desc 'Tag the repository for release.'
 task :tag do
   version = ActiveSambaLdap::VERSION
@@ -129,40 +128,6 @@ end
 desc "Distribute new release."
 task :dist => [:publish_docs, :release, :tag, :announce]
 
-# # fix Hoe's incorrect guess.
-# project.spec.executables.clear
-# project.bin_files = project.spec.files.grep(/^bin/)
-
-# fix Hoe's install and uninstall task.
-task(:install).instance_variable_get("@actions").clear
-task(:uninstall).instance_variable_get("@actions").clear
-
-task :install do
-  [
-   [project.lib_files, "lib", Hoe::RUBYLIB, 0444],
-   [project.bin_files, "bin", File.join(Hoe::PREFIX, 'bin'), 0555]
-  ].each do |files, prefix, dest, mode|
-    FileUtils.mkdir_p dest unless test ?d, dest
-    files.each do |file|
-      base = File.dirname(file.sub(/^#{prefix}#{File::SEPARATOR}/, ''))
-      _dest = File.join(dest, base)
-      FileUtils.mkdir_p _dest unless test ?d, _dest
-      install file, _dest, :mode => mode
-    end
-  end
-end
-
-desc 'Uninstall the package.'
-task :uninstall do
-  Dir.chdir Hoe::RUBYLIB do
-    rm_f project.lib_files.collect {|f| f.sub(/^lib#{File::SEPARATOR}/, '')}
-  end
-  Dir.chdir File.join(Hoe::PREFIX, 'bin') do
-    rm_f project.bin_files.collect {|f| f.sub(/^bin#{File::SEPARATOR}/, '')}
-  end
-end
-
-
 desc "Update *.po/*.pot files and create *.mo from *.po files"
 task :gettext => ["gettext:po:update", "gettext:mo:create"]
 

data/bin/asl-groupadd

@@ -34,7 +34,7 @@ unless Process.uid.zero?
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 class Group < ActiveSambaLdap::Group
   ldap_mapping

data/bin/asl-groupadd.help

@@ -4,6 +4,7 @@ Usage: asl-groupadd [options] GROUP_NAME
                                      (domain)
     -p, --[no-]print-gid-number      print the gid number to stdout
                                      (false)
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-groupdel

@@ -28,7 +28,7 @@ unless Process.uid.zero?
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 class Group < ActiveSambaLdap::Group
   ldap_mapping

data/bin/asl-groupdel.help

@@ -1,6 +1,7 @@
 Usage: asl-groupdel [options] GROUP_NAME
     -f, --[no-]force                 force delete group
                                      (false)
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-groupmod

@@ -41,7 +41,7 @@ unless Process.uid.zero?
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 class Group < ActiveSambaLdap::Group
   ldap_mapping

data/bin/asl-groupmod.help

@@ -7,6 +7,7 @@ Usage: asl-groupmod [options] GROUP_NAME
         --add-members
     -d=MEMBER1,MEMBER2,MEBMER3       delete members (comma delimited)
         --delete-members
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-groupshow

@@ -17,7 +17,7 @@ else
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("reference")
+ActiveSambaLdap::Base.setup_connection("reference")
 
 class Group < ActiveSambaLdap::Group
   ldap_mapping

data/bin/asl-groupshow.help

@@ -1,4 +1,5 @@
 Usage: asl-groupshow [options] GROUP_NAME
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-passwd

@@ -42,7 +42,7 @@ if !options.update_samba_password and !options.update_unix_password
   exit
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 class User < ActiveSambaLdap::User
   ldap_mapping

data/bin/asl-passwd.help

@@ -3,6 +3,7 @@ Usage: asl-passwd [options] [USER_NAME]
                                      (true)
     -u, --[no-]unix-password         update UNIX password
                                      (true)
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-populate

@@ -41,7 +41,7 @@ argv, opts, options = ActiveSambaLdap::Command.parse_options do |opts, options|
   opts.on("--administrator-gid=GID", Integer,
           _("administrator's gid number"),
           "(#{options.administrator_gid})") {|options.administrator_gid|}
-  opts.on("-g", "--guest=NAME",
+  opts.on("--guest=NAME",
           _("guest login name"),
           "(#{options.guest})") {|options.guest|}
   opts.on("--guest-uid=UID", Integer,
@@ -61,7 +61,7 @@ unless Process.uid.zero?
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 entries, opts = ActiveSambaLdap::Base.populate(options.marshal_dump)
 

data/bin/asl-populate.help

@@ -16,6 +16,7 @@ Usage: asl-populate [options]
         --guest-gid=GID              guest's gid number
                                      (514)
     -e, --export-ldif=LDIF           export LDIF file
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-purge

@@ -17,7 +17,7 @@ unless Process.uid.zero?
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 ActiveSambaLdap::Base.purge
 

data/bin/asl-purge.help

@@ -1,4 +1,5 @@
 Usage: asl-purge [options]
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-samba-computeradd

@@ -34,7 +34,7 @@ unless Process.uid.zero?
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 
 class User < ActiveSambaLdap::User

data/bin/asl-samba-computeradd.help

@@ -1,6 +1,7 @@
 Usage: asl-samba-computeradd [options] COMPUTER_NAME
     -o, --ou=OU                      add the user in the organizational unit OU
                                      (relative to the user suffix)
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-samba-groupadd

@@ -22,7 +22,7 @@ unless Process.uid.zero?
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 class Group < ActiveSambaLdap::Group
   ldap_mapping :recommended_classes => []

data/bin/asl-samba-groupadd.help

@@ -1,4 +1,5 @@
 Usage: asl-samba-groupadd [options] GROUP_NAME
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files:

data/bin/asl-samba-groupdel

@@ -22,7 +22,7 @@ unless Process.uid.zero?
   exit 1
 end
 
-ActiveSambaLdap::Base.establish_connection("update")
+ActiveSambaLdap::Base.setup_connection("update")
 
 class Group < ActiveSambaLdap::Group
   ldap_mapping :recommended_classes => []

data/bin/asl-samba-groupdel.help

@@ -1,4 +1,5 @@
 Usage: asl-samba-groupdel [options] GROUP_NAME
+
 Common options:
         --config=CONFIG              Specify configuration file
                                      Default configuration files: