区分 02 / 結線八本

結線例

八本の線と、切れやすい箇所

結線は、目的から逆に引きます。先にコマンドを並べるのではなく、何を確かめたいかを決め、 そのために必要な端子を左から順に繋ぐ。この順序を守るだけで、途中で詰まったときに どこまで動いているのかが分かります。

八本とも、実際の作業で何度も書き直した形です。分解の欄には、一字ずつ打つ順序を書きました。 切れる箇所の欄には、エラーを出さずに結果だけを変える落とし穴を書いてあります。

結線 01

日本語名を含む一覧を、壊さずに数える

find . -type f -print0 | xargs -0 -n1 basename | sort | uniq -d

名前の区切りを改行から NUL に変えると、空白を含むディレクトリ名でも途中で切れません。最後の uniq -d は、別々の場所にある同名ファイルを拾います。

分解

  1. find で対象を絞る。-type f を付けないとディレクトリも混ざる。
  2. -print0 で NUL 区切りにする。ここを -print にすると、この先が全部崩れる。
  3. xargs -0 で受け、-n1 で一件ずつ basename に渡す。
  4. sort してから uniq -d で重複だけを残す。

切れる箇所

xargs 側の -0 を落とすと、空白で名前が分割され、basename が別のファイルを指します。エラーは出ません。

結線 02

直近のエラーを、時刻ごとに数える

grep -h 'ERROR' /var/log/app.log | cut -c1-13 | sort | uniq -c | sort -nr | head -5

ISO 8601 の日時なら、先頭十三文字で「2026-11-13T09」までが残ります。時刻ごとにまとめて数え、多い順に五件だけ出します。ログの書式が変わったら cut の数字だけを直します。

分解

  1. grep -h でファイル名の前置を消す。ここが崩れると cut の位置がずれる。
  2. cut -c1-13 で日時の部分だけを残す。バイト指定の -b は日本語で壊れるので使わない。
  3. sort して同じ時刻を隣り合わせ、uniq -c で数える。
  4. sort -nr で多い順にし、head -5 で上位だけ見る。

切れる箇所

複数ファイルを一度に渡すときは -h が必須です。付いていないと cut がファイル名の文字を切ります。

結線 03

文字コードを見分けてから変換する

file -I sheet.csv && iconv -f SHIFT_JIS -t UTF-8 sheet.csv > sheet-utf8.csv

まず現物の文字コードを確かめ、そのうえで変換します。当て推量で変換すると、二重変換で読めない文字列ができます。

分解

  1. file -I で charset を見る。empty や unknown が返るなら中身が壊れている。
  2. 先頭三バイトを od で見て、BOM の有無を確かめる。
  3. iconv で変換し、別名で保存する。元のファイルは残す。
  4. 変換後に wc -m で文字数が極端に減っていないか見る。

切れる箇所

iconv は変換できない文字に当たるとそこで止まります。//TRANSLIT を付けると別の文字に置き換わり、静かに意味が変わります。

結線 04

改行コードを揃える

find . -name '*.sh' -print0 | xargs -0 sed -i '' $'s/\r$//'

Windows から来たスクリプトは、行末の CR のせいで bad interpreter になります。対象を絞ってから、その場で落とします。

分解

  1. find で拡張子を絞る。全ファイルに当てない。
  2. file で CRLF を確かめておく。混在していることもある。
  3. BSD の sed は -i のあとに空文字を渡す。GNU なら -i だけでよい。
  4. 実行してから bash -n で構文だけを再確認する。

切れる箇所

GNU の sed に -i '' を渡すと、空の拡張子を処理しようとして失敗します。環境を確かめてから打ってください。

結線 05

リモートへ、差分だけを送る

rsync -avn --delete ./dist/ user@host:/srv/app/

送り元の末尾スラッシュは「中身を送る」の意味です。付け忘れると dist というディレクトリごと送られ、宛先が一段深くなります。まず -n で消える側を確認します。

分解

  1. 送り元の末尾にスラッシュを付ける。ここが最初の関門。
  2. -a で属性を保ち、-v で送った内容を出す。
  3. -n を付けて一度走らせ、削除予定の行だけを読む。
  4. 問題がなければ -n を外して同じ命令を打つ。

切れる箇所

--delete は宛先にしかないファイルを消します。バックアップを別に取っていない状態で、確認なしに打たないでください。

結線 06

API の応答から、件数と失敗を読む

curl -sS --fail-with-body https://httpbin.org/json | jq -r '.slideshow.slides | length'

curl は 4xx と 5xx でも終了コード 0 を返します。-s だけだと本文だけが流れて、失敗に気づけません。--fail-with-body を付けると、本文を残したまま異常終了します。

分解

  1. -sS で進捗を消し、エラーの理由だけは出す。
  2. --fail-with-body で 4xx と 5xx を異常終了にする。
  3. jq -r で引用符を外し、length で件数を取る。
  4. echo $? で終了コードを確かめてから次へ進む。

切れる箇所

パイプの途中で失敗しても、パイプ全体の終了コードは最後の jq のものになります。set -o pipefail を先に置いてください。

結線 07

作業ディレクトリを、固めて確かめる

tar -czf ../backup-$(date +%Y%m%d).tgz --exclude='node_modules' --exclude='.next' .

除外は対象より前に書きます。後ろに置くと、環境によっては黙って無視されます。固めたあとは、展開せずに中身を数えます。

分解

  1. --exclude を対象の . より前に並べる。
  2. ファイル名に日付を入れて、上書きを避ける。
  3. tar -tzf で一覧を出し、先頭と末尾だけ目で見る。
  4. tar -tzf backup.tgz | wc -l で件数を控える。

切れる箇所

macOS の bsdtar は --exclude の解釈が GNU と微妙に違います。除外したい名前は、まず -tzf の一覧に出ていないかで確かめるのが確実です。

結線 08

容量を食っている場所を見つける

du -xhd1 /var | sort -h | tail -5

-x で別のファイルシステムに降りず、-d1 で一階層だけ見ます。sort -h は単位付きの数値をそのまま並べられるので、K と G が混ざっても順序が壊れません。

分解

  1. du -xhd1 で一階層の合計を出す。
  2. sort -h で小さい順にし、tail で大きいものだけ見る。
  3. 見当を付けたら、その下で同じ命令を打つ。
  4. 消す前に find で対象を列挙し、件数と合計を確かめる。

切れる箇所

du は権限の無いディレクトリを黙って飛ばします。合計が df と合わないときは、sudo を付けて一度取り直してください。

二枚の端子板の間に渡された布巻きの配線。手前で交差し、真鍮の螺子が光っている
配線交差している線は、どちらが先に渡してあるかで保守の順序が決まる。結線を読むとは、その順序を読むことでもある。

線を引く順序

長い結線を一度に書くと、動かないときに原因を切り分けられません。まず一段だけ打って、 出力を目で見る。次に二段目を足して、また見る。この往復を省いた結線は、たいてい どこかで静かに壊れています。パイプの途中を見たいときは tee を挟みます。

もう一つ、読む順序の話。端末の結線は左から右へ流れますが、直すときは右から読みます。 最後の出力が欲しい形になっていないなら、その手前の段が何を渡しているかを見る。 逆引の表は、その行き来のためにあります。逆引表へ