Sophie: yash-doc-2.28-1.fc14 noarch

yash-doc-2.28-1.fc14.noarch.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
    "http://www.w3.org/TR/html4/strict.dtd">
<html lang="ja">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="Content-Script-Type" content="text/javascript">
<meta http-equiv="Content-Style-Type" content="text/css">
<meta name="author" content="magicant">
<meta name="description" content="Yash の cd 組込みコマンドについて">
<title>Yash マニュアル: cd 組込みコマンド</title>
<link rel="Contents" href="../index.html" title="目次">
<link rel="Prev" href="break.html" title="Break 組込みコマンド">
<link rel="Next" href="command.html" title="Command 組込みコマンド">
<link rel="Stylesheet" href="../style.css">

<div class="breadcrumb"><a href="../index.html">目次</a> >
<a rel="Up" href="index.html">組込みコマンド一覧</a></div>
<h1>Cd 組込みコマンド</h1>

<p><dfn>Cd 組込みコマンド</dfn>はシェルの作業ディレクトリを変更します。

<h2 id="syntax">構文</h2>
<ul>
<li><code>cd [-LP] [<var>ディレクトリ</var>]</code>
</ul>

<h2 id="description">説明</h2>
<p>Cd コマンドはシェルの作業ディレクトリをオペランドで指定したディレクトリに変更します。新しい作業ディレクトリに応じて <a href="../params.html#sv-pwd"><code>PWD</code> 変数</a>の値が再設定されるとともに、前の <code>PWD</code> 変数の値が <a href="../params.html#sv-oldpwd"><code>OLDPWD</code> 変数</a>に設定されます。
<p>指定した<var>ディレクトリ</var>が相対パスの場合 (最初が <code>.</code> または <code>..</code> で始まるものを除く)、<a href="../exec.html#search">コマンドの検索</a>における <a href="../params.html#sv-path"><code>PATH</code> 変数</a>の検索と同様にして、<a href="../params.html#sv-cdpath"><code>CDPATH</code> 変数</a>の値にあるコロンで区切った各ディレクトリ内に指定した<var>ディレクトリ</var>があるかどうか調べます。ディレクトリが見つかった場合は、そのディレクトリが新しい作業ディレクトリになります。
<p><code>CDPATH</code> 変数の検索で新しい作業ディレクトリが見つかった場合または<var>ディレクトリ</var>として <code>-</code> が指定された場合は新しい作業ディレクトリのパスを標準出力に出力します。
<p>作業ディレクトリの変更に成功した場合、<a href="../params.html#sv-yash_after_cd"><code>YASH_AFTER_CD</code> 変数</a>が設定されていればその値がコマンドとして解釈・実行されます (非 <a href="../posix.html">POSIX 準拠モード</a>時)。

<h2 id="options">オプション</h2>
<dl>
<dt><code>-L</code>, <code>--logical</code>
<dd>ディレクトリパスに含まれるシンボリックリンクを解決せずに新しい作業ディレクトリを決定します。新しい <code>PWD</code> 変数の値にはシンボリックリンクになっているパス名コンポーネントがそのまま残ります。
<dt><code>-P</code>, <code>--physical</code>
<dd>ディレクトリパスに含まれるシンボリックリンクを解決します。新しい <code>PWD</code> 変数の値はシンボリックリンクを含みません。
<dt><code>--default-directory=<var>ディレクトリ</var></code>
<dd><var>ディレクトリ</var>オペランドが与えられていない場合は、代わりにこのオプションで指定した<var>ディレクトリ</var>を新しい作業ディレクトリとします。
</dl>
<p><code>-L</code> (<code>--logical</code>) オプションと <code>-P</code> (<code>--physical</code>) オプションの両方を指定した場合、後に指定したほうを優先します。どちらも指定していない場合は、<code>-L</code> を指定したものとみなします。

<h2 id="operands">オペランド</h2>
<dl>
<dt><var>ディレクトリ</var>
<dd>新しい作業ディレクトリのパス名です。絶対パスまたは元の作業ディレクトリからの相対パスで指定します。この値がハイフン一つ (<code>-</code>) の場合、<code>OLDPWD</code> 変数の値が指定されたものとみなします。このオペランドが与えられていない場合、<a href="../params.html#sv-home"><code>HOME</code> 変数</a>の値が指定されたものとみなします (<code>--default-directory</code> オプションを指定した場合を除く)。
</dl>

<h2 id="exitstatus">終了ステータス</h2>
<p>作業ディレクトリを正しく変更できた場合、終了ステータスは 0 です。エラーがあると終了ステータスは非 0 です。

<h2 id="notes">補足</h2>
<p>Cd コマンドは<a href="../builtin.html#types">準特殊組込みコマンド</a>です。
<p>POSIX には <code>YASH_AFTER_CD</code> 変数に関する規定はありません。POSIX は<var>ディレクトリ</var>としてハイフン一つを指定したときに <code>-L</code> または <code>-P</code> オプションを併用することを認めていません。
<p><code>YASH_AFTER_CD</code> 変数の値の実行結果の終了ステータスは cd コマンドの終了ステータスに影響しません。