netatalk.io

Netatalk 4.5.0

名前

nad - Netatalk AppleDouble ファイルユーティリティ 一式

概要

nad [-F configfile] [ls | cp | mv | rm | mkdir | rmdir | set | find] […]

nad [-v | --version]

説明

nad は、Netatalk ホスト上で AFP 共有ボリューム内のファイルおよびディレクトリを 操作するために使用できるファイルユーティリティ一式である。 AppleDouble データ(ファイルの拡張属性、._ ファイル、または .AppleDouble ディレクトリ内のファイルのいずれか)および CNID データベースは、共有 Netatalk ボリューム内のファイルが変更されると適切に更新される。

nadを使用することは、Netatalk共有ボリューム内のファイルおよびディレクトリに対するオペレーティングシステムのネイティブなファイル操作コマンドよりも好ましい。なぜなら、Mac OSのメタデータの整合性とCNIDデータベースの正確性を維持するからである。

これは、ホストシステムでNetatalkが実行されており、AFPボリュームがNetatalkによって共有されていることに依存する。

ファイルおよびディレクトリにアクセスするための適切な権限を持つユーザーのみが、nadを使用してそれらを操作できる。これは、ホストシステムでNetatalkが実行されており、AFPボリュームがNetatalkによって共有されていることに依存する。

オプション

-F configfile

Netatalk 設定ファイルへのフルパスとして configfile を使用する。

有効なコマンド

ファイルやディレクトリをリストする。

nad ls [-adlRu] {file|directory […]}

ファイルやディレクトリをコピーする。

nad cp [-aipvf] {src_file} {dst_file}

nad cp -R [-aipvf] {src_file|src_directory …} {dst_directory}

ファイルやディレクトリを移動する。

nad mv [-finv] {src_file} {dst_file}

nad mv [-finv] {src_file|src_directory …} {dst_directory}

ファイルやディレクトリを削除する。

nad rm [-Rv] {file|directory}

ディレクトリを作成する。

nad mkdir [-pv] {directory […]}

空のディレクトリを削除する。

nad rmdir [-pv] {directory […]}

ファイルにメタデータを設定する。

nad set [-t type] [-c creator] [-l label] [-f flags] [-a attributes] {file}

ファイルやディレクトリを検索する。

nad find [-v volume_path] {name}

バージョンを表示する。

nad -v | --version

nad ls

AFP ボリューム内のファイルおよびディレクトリをリストする。長い出力モードでは、AppleDouble メタデータと CNID が表示される。

オプション:

-a

名前がドット (.) で始まるディレクトリエントリも含める

-d

ディレクトリを単純なファイルとしてリストする

-l

長い出力。AFP infoをリストする

-R

サブディレクトリを再帰的にリストする

-u

UNIX infoをリストする

長い出力の説明

<unixinfo> <FinderFlags> <AFP Attributes> <Color> <Type> <Creator> <CNID from AppleDouble> <name>

FinderFlags (valid for (f)iles and/or (d)irectories):

  d = On Desktop                      (f/d)
  e = Hidden extension                (f/d)
  m = Shared (can run multiple times) (f)
  n = No INIT resources               (f)
  i = Inited                          (f/d)
  c = Custom icon                     (f/d)
  t = Stationery                      (f)
  s = Name locked                     (f/d)
  b = Bundle                          (f/d)
  v = Invisible                       (f/d)
  a = Alias file                      (f/d)

AFP Attributes:

  y = System                          (f/d)
  w = No write                        (f)
  p = Needs backup                    (f/d)
  r = No rename                       (f/d)
  l = No delete                       (f/d)
  o = No copy                         (f)

Note: any letter appearing in uppercase means the flag is set but it's a directory for which the flag is not allowed.

nad cp

AFP ボリューム内のファイルやディレクトリをコピーする。

上の概要で示した一番目の形式では、cpユーティリティはsrc_fileの内容をdst_fileへコピーする。二番目の形式では、それぞれの名前のsrc_fileの内容は配布先のdst_directoryにコピーされる。ファイル自身の名前は変更されない。ファイルを自分自身へコピーしようとしているのをcpが検出したら、コピーは失敗する。

AFPボリュームへのコピーであると検出された場合、CNIDデータベースデーモンに接続し、全てのコピーはCNIDデータベースの手続きを踏む。ターゲットがAFPボリュームの場合はAppleDoubleデータもまたコピーされ、必要なら作成される。

オプション:

-a

アーカイブモード。-Rp と同じ。

-f

それぞれの配布先パス名が既に存在している場合、それを削除してから新しいファイルを作成する。 パーミッションに関わらず確認プロンプトを出さない。 (-f オプションは手前の -i オプションと -n オプションを無効にする。)

-i

存在するファイルに上書きする前に、標準エラー出力にプロンプトを出す。 もし標準入力からの返答が’y’または’Y’で始まるならばファイルコピーを試みる。 (-i オプションは手前の -f オプションと -n オプションを無効にする。)

-n

存在するファイルを上書きしない。 (-n オプションは手前の -f オプションと-iオプションを無効にする。)

-p

以下に示すそれぞれのコピー元ファイルの属性を、パーミッションが許す限り維持する: 変更時刻、アクセス時刻、ファイルフラグ、ファイルモード、ユーザIDグループID。 ユーザIDとグループIDが維持されない場合、エラーメッセージは表示されず、終了コードは変更されない。

-R

もしsrc_fileでディレクトリを指定した場合、cpはそのディレクトリと全体のサブツリーをコピーする。 もしsrc_fileが「/」で終わっている場合、ディレクトリ自身ではなく中身をコピーする。

-v

コピーしたファイルを詳細に表示する。

-x

ファイルシステムのマウントポイントを横断しない。

nad mv

ファイルやディレクトリを移動する。

AFPボリューム内のファイルを移動し、必要に応じてCNIDデータベースを更新する。以下のどちらかの場合はファイルをコピーしてからコピー元を削除する。

オプション:

-f

配布先パスに上書きする前に確認プロンプトを出さない。(-f オプションは手前の -i オプションと -n オプションを無効にする。)

-i

存在するファイルに上書きする前に、標準エラー出力にプロンプトを出す。 もし標準入力からの返答が’y’または’Y’で始まるならば移動を試みる。 (-i オプションは手前の -f オプションと -n オプションを無効にする。)

-n

存在するファイルを上書きしない。 (-n オプションは手前の -f オプションと-iオプションを無効にする。)

-v

移動したファイルを詳細に表示する。

nad rm

AFP ボリューム内のファイルやディレクトリを削除する。

rm ユーティリティはコマンドラインで指定した非ディレクトリ型のファイルを削除しようと試みる。対応する CNID はボリュームのデータベースから削除され、AppleDouble メタデータも削除される。

オプションは次の通り。

-R

それぞれのファイル引数の下のファイル階層を削除しようと試みる。

-v

ファイルを削除するときに詳細を表示する。

nad mkdir

AFP ボリューム内にディレクトリを作成する。対応する CNID がボリュームのデータベースに追加され、AppleDouble メタデータが初期化される。

オプションは次の通り。

-p

必要に応じて中間ディレクトリを作成する。 中間ディレクトリまたはターゲットディレクトリがすでに存在していてもエラーとはみなさない。

-v

ディレクトリを作成するときに詳細を表示する。

nad rmdir

AFP ボリューム内の空のディレクトリを削除する。対応する CNID がボリュームのデータベースから削除され、AppleDouble メタデータも削除される。

ボリュームのルートディレクトリとその親ディレクトリは削除できない。

オプションは次の通り。

-p

各オペランドは、空であれば最後のコンポーネントから順にすべてのコンポーネントを 削除するパス名として扱われる。ボリュームのルートディレクトリやその親は削除しない。

-v

ディレクトリを削除するときに詳細を表示する。

nad set

ファイルにメタデータを設定する。

set ユーティリティは、AFP ボリューム内のファイルのメタデータを変更する。

オプションは次の通り。

-t type

ファイルの4文字コードのファイルタイプを変更する。

-c creator

ファイルの4文字コードのクリエータを変更する。

-l label

ファイルの色ラベルを変更する。使用可能な色については、以下のリストを参照。

-f flags

ファイルの Finder フラグを変更する。使用可能なフラグについては、以下のリストを参照。大文字はフラグを設定し、小文字はフラグを削除する。

-a attributes

ファイルの属性を変更する。使用可能な属性については、以下のリストを参照。大文字はフラグを設定し、小文字はフラグを削除する。

旗の説明

Color Labels:

  none | grey | green | violet | blue | yellow | red | orange

Finder Flags (valid for (f)iles and/or (d)irectories):

  d = On Desktop                      (f/d)
  e = Hidden extension                (f/d)
  m = Shared (can run multiple times) (f)
  n = No INIT resources               (f)
  i = Inited                          (f/d)
  c = Custom icon                     (f/d)
  t = Stationery                      (f)
  s = Name locked                     (f/d)
  b = Bundle                          (f/d)
  v = Invisible                       (f/d)
  a = Alias file                      (f/d)

AFP Attributes:

  y = System                          (f/d)
  w = No write                        (f)
  p = Needs backup                    (f/d)
  r = No rename                       (f/d)
  l = No delete                       (f/d)
  o = No copy                         (f)

nad find

AFPボリューム内のファイルやディレクトリを検索する。

指定されたファイル名と完全にまたは部分的に一致するパスのリストを返す。

オプション:

-v path

現在の作業ディレクトリの代わりに、共有ボリュームへのパスを使用して検索する。

共有AFPボリューム内のファイルをリストする:

$ nad ls -al /srv/afpshare
---Nic-s--- ------ --- ---- ----           2   .
----------- ------ --- ---- ----           1   ..
----i---b-- ------ --- APPL SBMC          40   AppleShare IP Browser
---------v- ------ --- ---- ----          36   Network Trash Folder
-------s-v- ------ --- ---- ----          35   TheVolumeSettingsFolder
----ic-s--- ------ gre PNGf GKON          39   picture 1.png
----ic----- ------ --- PNGf GKON          41   picture 2.png
----ic----- ------ --- PNGf GKON          42   picture 3.png

凡例:

共有 AFP ボリューム /srv/afpshare 内で名前に「Report」を含むファイルを検索する:

$ nad find -v /srv/afpshare Report
/srv/afpshare/Documents/2025/Report January 2025.doc
/srv/afpshare/Documents/2024/Report December 2024.doc
/srv/afpshare/Documents/Report Template.doc

参照

dbd(1), addump(1)

著者

CONTRIBUTORS を参照