ユーザーコマンド                                            ln(1)

【名前】
     ln - ファイルへのハードリンクまたはシンボリックリンクの作成

【形式】
     /usr/bin/ln [-fns] source_file [target]

     /usr/bin/ln [-fns] source_file ... target

     /usr/xpg4/bin/ln [-fs] source_file [target]

     /usr/xpg/bin/ln [-fs] source_file ... target

【機能説明】
     上記 2 つの形式のうち、第 1 の形式の ln ユーティリ ティ は、
     source_file が示すファイル用に新しいディレクトリエントリ (リ
     ンク) を、target が示す宛先パスに作成します。target が省略さ
     れると、カレントディレクトリ内にリンクを作成します。最終オペ
     ランドが既存のディレクトリを指していなければ、この第 1 の 形
     式 の  ln  呼び出しと見なされます。オペランドの数が 3 つ以上
     で、最終オペランドが既存のディレクトリではない場合、エラーと
     なります。

     第 2 の形式の ln ユーティリティは、source_file オペランド で
     示 された各ファイル用に新しいディレクトリを、target が示す既
     存のディレクトリの宛先パスに作成します。

     ln ユーティリティは、ハードリンクとシンボリックリンクの両 方
     を作成することができます。ハードリンクはファイルへのポインタ
     で、元のディレクトリエントリと区別されません。ファイルに加え
     られる変更は、そのファイルの参照にどの名前が使用されたかにか
     かわらず有効です。ハードリンクは、複数のファイルシステムにま
     たがることはできません。また、ディレクトリも参照することはで
     きません。

     デフォルトでは、ln はハードリンクを作成しま す。 source_file
     は  target にリンクされます。target がディレクトリの場合は、
     target の中に source_file という名前の別のファイルが作 成 さ
     れ、元の source_file にリンクされます。

     target がファイルで -f オプションが指定されていない場合 は、
     /usr/xpg4/bin/ln  は標準エラーに診断メッセージを書き込み、現
     在の source_file には何も行わず、他の残りの source_file に処
     理を進めます。

     シンボリックリンクはファイルへの間接的なポインタで、そのディ
     レ ク トリエントリにはリンク先のファイルの名前が書かれていま
     す。シンボリックリンクはファイルシステムをまたぐことができ、
     またディレクトリを参照することもできます。

     target のアクセス権は -l を付けた ls(1) コマンドで表示される
     ア クセス権とは、異なる場合があります。target のアクセス権を
     表示する場合は、ls -lL を使用してください。詳細について は、
     stat(2) を参照してください。

  ［/usr/bin/ln］
     /usr/bin/ln は、target のモードが書き込み禁止であった場 合、
     そ のモード (chmod(1) を参照) を出力し、応答を要求し、標準入
     力から 1 行を読み取ります。応答が肯定である場合、アクセス 権
     が与えられていればリンクが行われ、アクセス権が与えられていな
     ければコマンドは終了します。

  ［/usr/xpg4/bin/ln］
     ハードリンクを作成する時や、リンク元のファイル自体がシ ン ボ
     リッ ク リンクである時、リンク先は、シンボリックリンクのオブ
     ジェクト自体 (source_file) へのハードリンクではなく、シン ボ
     リックリンクによって参照されているファイルへのハードリンクに
     なります。

【オプション】
     以下のオプションは、/usr/bin/ln と /usr/xpg4/bin/ln で指定で
     きます。

     -f              target のモードで書き込みが禁止され て い て
                     も、ユーザーに問い合わせることをしないリンク
                     ファイル。標準入力が端末でない場合、デフォル
                     トはこの設定になっています。



     -s              シンボリックリンクを作成します。

                     -s オプションに 2 つの引数を指定する 場 合、
                     target  に指定できるのは、既存のディレクトリ
                     または存在しないファイルです。target がす で
                     に存在し、ディレクトリでもない場合は、エラー
                     が返されます。ファイル名 source_file に は、
                     あらゆるパス名を指定でき、それは既存のもので
                     ある必要はありません。既存のパス名にする場合
                     は、 ファ イルとディレクトリのいずれも指定で
                     き、また、target とは異なるファイルシステ ム
                     に あ るものを指定することもできます。target
                     が既存のディレクトリである場合は、ディレクト
                     リ   target  の 中 に  source_file  ま た は
                     source_file の最後の構成要素の名前の付 い た
                     ファ イ ル が 作成されます。このファイルは、
                     source_file を参照するシンボリックリン ク で
                     す。target が存在しない場合は、target という
                     名前のファイルが作成され、source_file を参照
                     するシンボリックリンクになります。

                     -s オプションに 3 つ以上の引数を指定する場合
                     は、 target は既存のディレクトリでなければな
                     りません。既存のディレクトリでない場合は、エ
                     ラーが返されます。source_file ごとに、target
                     の中に source_file の最後の構成要素の名前 の
                     付 い た リ ン ク が 作 成 さ れます。新しい
                     source_file は、それぞれ、元 の  source_file
                     へ の シンボリックリンクです。ファイルとター
                     ゲットは、異なるファイルシステムにあってもか
                     まいません。



  ［/usr/bin/ln］
     以下のオプションは、/usr/bin/ln でのみ指定できます。

     -n              target が既存のファイルである場合、診断 メッ
                     セー ジ を 標 準 エ ラーに書き込んで、残りの
                     source_file に処理を進めます。-f オプショ ン
                     を 使 用すると、このオプションは無効になりま
                     す。これは /usr/bin/ln  と  /usr/xpg4/bin/ln
                     のデフォルトの動作であるため、指定しても無視
                     されます。



【オペランド】
     以下のオペランドを指定できます。

     source_file     リンクされるファイルのパス名。これは、 通 常
                     ファイル、特殊ファイルのどちらでもかまいませ
                     ん。-s オプションが指定され た 場 合 に は、
                     source_file にはディレクトリを指定することも
                     できます。



     target          新しいディレクトリエントリのパス名、または新
                     しいディレクトリエントリが作られる既存ディレ
                     クトリのパス名。



【使用法】
     ファイルが 2 ギガバイト (2**31 バイト) 以上ある場合の ln  の
     動作については、largefile(5) を参照してください。

【環境】
     ln の実行に影響を与える環 境 変 数  LC_CTYPE、 LC_MESSAGES、
     NLSPATH についての詳細は、environ(5) を参照してください。

【終了ステータス】
     以下の終了ステータスが返されます。

     0        指定されたファイルはすべて正常にリンクされた


     >0       エラーが発生した



【属性】
     次の属性については attributes(5) のマニュアルページを参照 し
     てください。

  ［/usr/bin/ln］
     ____________________________________________________________
    |         属性タイプ          |            属性値           |
    |_____________________________|_____________________________|
    | 使用条件                    | SUNWcsu                     |
    |_____________________________|_____________________________|
    | CSI                         | 対応済み                    |
    |_____________________________|_____________________________|

  ［/usr/xpg4/bin/ln］
     ____________________________________________________________
    |         属性タイプ          |            属性値           |
    |_____________________________|_____________________________|
    | 使用条件                    | SUNWxcu4                    |
    |_____________________________|_____________________________|
    | CSI                         | 対応済み                    |
    |_____________________________|_____________________________|
    | インタフェースの安定性      | 標準                        |
    |_____________________________|_____________________________|

【関連項目】
     chmod(1)、ls(1)、stat(2)、attributes(5)、environ(5)、 large-
     file(5)、XPG4(5)

【注意事項】
     ディレクトリへのシンボリックリンクは、予想とは異なった動作を
     す る場合があります。シンボリックリンクに対して ls(1) を実行
     すると、指定したディレクトリ中のファイルが表示されますが、一
     方 ls -l はリンク自体の情報を表示します。


          example% ln -s dir link
          example% ls link
          file1 file2 file3 file4
          example% ls -l link
          lrwxrwxrwx  1 user            7 Jan 11 23:27 link -> dir


     /usr/bin/sh または /usr/bin/csh を使用して、シンボリックリン
     クを介したディレクトリに変更すると (cd(1) のマニュアルページ
     参照)、ファイルシステム中の指定位置に移ることになります。 つ
     まり新たな作業ディレクトリの親は、シンボリックリンクの親では
     なく、指定されたディレクトリの親 に な り ま す。 こ れ は、
     /usr/bin/ksh または /usr/xpg4/bin/sh から、-P オプションを付
     けて cd を実行するときにも発生します。以下に示す例で、最終的
     な 作業ディレクトリは /home/user/linktest ではなく /usr であ
     る点に注意してください。


          example% pwd
          /home/user/linktest
          example% ln -s /usr/tmp symlink
          example% cd symlink
          example% cd ..
          example% pwd
          /usr


     C シェルのユーザーは、cd の代わりに C シェルの組み込みコマン
     ド である pushd や popd を使えば、ディレクトリ移動がこのよう
     に複雑になるのを回避できます。