docs/ldid.zh_TW.1

   1 .\"-
   2 .\" Copyright (c) 2021-2022 Procursus Team <team@procurs.us>
   3 .\" SPDX-License-Identifier: AGPL-3.0-or-later
   4 .\"
   5 .Dd January 20, 2022
   6 .Dt LDID 1
   7 .Os
   8 .Sh 名稱
   9 .Nm ldid
  10 .Nd 鏈接身份編輯器
  11 .Sh 語法
  12 .Nm
  13 .Op Fl A Ns Ar 處理器類型 : Ns Ar 亞類型
  14 .Op Fl a
  15 .Op Fl C Ns Op Ar adhoc | Ar enforcement | Ar expires | Ar hard | Ar host | Ar kill | Ar library-validation | Ar restrict | Ar runtime
  16 .Op Fl D
  17 .Op Fl d
  18 .Op Fl E Ns Ar 數字 : Ns Ar 檔案
  19 .Op Fl e
  20 .Op Fl H Ns Op Ar sha1 | Ar sha256
  21 .Op Fl h
  22 .Op Fl I Ns Ar 名稱
  23 .Op Fl K Ns Ar 密錀.p12 Op Fl U Ns Ar 密碼
  24 .Op Fl M
  25 .Op Fl P Ns Op Ar 數字
  26 .Op Fl Q Ns Ar 需求
  27 .Op Fl q
  28 .Op Fl r | Fl S Ns Ar 檔案.xml | Fl s
  29 .Op Fl u
  30 .Op Fl arch Ar 架構類型
  31 .Ar 檔案......
  32 .Sh 描述
  33 .Nm
  34 把SHA1和SHA256雜湊值加入到Mach-O檔案中，
  35 讓它們能在有驗證但沒有簽署驗證的系統上運行。
  36 .Bl -tag -width -indent
  37 .It Fl A Ns Ar 處理器類型 : Ns Ar 亞類型
  38 當和
  39 .Fl a
  40 、
  41 .Fl d
  42 、
  43 .Fl e
  44 、
  45 .Fl h
  46 、
  47 .Fl q
  48 或
  49 .Fl u
  50 一起被使用時，只作用在被
  51 .Ar 處理器類型
  52 和
  53 .Ar 亞類型
  54 指定的部分。
  55 .Ar 處理器類型
  56 和
  57 .Ar 亞類型
  58 都應該是整數。
  59 .It Fl a
  60 以十六進制印出處理器類型和亞類型。
  61 .It Fl arch Ar 架構類型
  62 和
  63 .Fl A
  64 一樣，不過使用架構的名稱。
  65 已知的
  66 .Ar 架構類型 Ns
  67 可以在
  68 .Xr arch 3
  69 中找到。
  70 這是一個Procursus擴展。
  71 .It Fl C Ns Op Ar adhoc | Ar enforcement | Ar expires | Ar hard | Ar host | Ar kill | Ar library-validation | Ar restrict | Ar runtime
  72 設定要在檔案中包含的程式碼簽署選項。
  73 請看
  74 .Xr codesign 1
  75 來獲得關於這些選項的更多資訊。
  76 .It Fl D
  77 重設加密碼 (cryptid)。
  78 .It Fl d
  79 輸出在二進位檔案中的加密碼。
  80 .It Fl E Ns Ar 數字 : Ns Ar 檔案
  81 將
  82 .Ar 檔案
  83 的雜湊值嵌入到位於
  84 .Ar 數字
  85 的特殊代碼簽署位置中。
  86 .It Fl e
  87 把每一部分的權限印出，或印出
  88 .Fl A
  89 或
  90 .Fl arch
  91 所指定的部分的權限到
  92 .Ar 標準輸出
  93 。
  94 .It Fl H Ns Op Ar sha1 | Ar sha256
  95 禁用沒有指明的雜湊嗎。
  96 這個選項可以用來重現
  97 .Xr codesign 1
  98 只提供sha256簽署的預設行為。
  99 .It Fl h
 100 印出關於簽署的資訊，包括雜湊值的
 101 類型，選項，CDHash, 和 CodeDirectory 版本到
 102 .Ar 標準輸出
 103 。
 104 .It Fl I Ns Ar 名稱
 105 把二進制檔案簽署中的識別碼設定為
 106 .Ar 名稱
 107 。
 108 如沒有指明，就會使用二進位檔案的檔案名稱。
 109 .It Fl K Ns Ar 密錀.p12
 110 使用位於
 111 .Ar 密錀.p12
 112 的身份簽署。會給二進位檔案有一個有效的簽署，令它能夠在有簽署驗證的系統上運行。
 113 如果
 114 .Ar 密錀.p12
 115 有密碼的話，你會被詢問。也可以用
 116 .Fl U
 117 選項來提供密碼。
 118 .It Fl M
 119 當和
 120 .Fl S
 121 一起使用時，和現有的權限合併而不是取代它。在加入權限時有用。
 122 .It Fl P Ns Op Ar 數字
 123 將這個Mach-O二進位檔案標示為平台二進位檔案。
 124 如果提供了
 125 .Ar 數字
 126 ，那麼在CodeDirectory中的平台區域定會被設定為該數字。
 127 根據蘋果的二進位檔案，預設為13。
 128 使用
 129 .Fl P
 130 來設定平台是一個Procursus擴展。
 131 .It Fl Q Ns Ar 需求
 132 把需求嵌入到
 133 .Ar 需求
 134 中。
 135 .It Fl q
 136 印出被嵌入在二進位檔案中的需求。
 137 .It Fl r
 138 從Mach-O檔案中刪除簽署。
 139 .It Fl S Ns Op Ar 檔案.xml
 140 偽簽署Mach-O檔案。
 141 如果提供了
 142 .Ar 檔案.xml
 143 那麼在
 144 .Ar 檔案.xml
 145 中的權限會被嵌入到Mach-O中。
 146 .It Fl s
 147 重新簽署Mach-O檔案但保留現有權限。
 148 .It Fl U Ns Ar 密碼
 149 使用
 150 .Ar 密碼
 151 作為p12證書的密碼，而不是詢問。
 152 這是一個Procursus擴展。
 153 .It Fl u
 154 如果Mach-O檔案有和UIKit鏈結，印出被鏈結的UIKit版本。
 155 .El
 156 .Sh 例子
 157 指令：
 158 .Pp
 159 .Dl "ldid -S 檔案"
 160 .Pp
 161 會偽簽署
 162 .Ar 檔案
 163 而且不嵌入任何權限。
 164 .Pp
 165 指令：
 166 .Pp
 167 .Dl "ldid -Cadhoc -K/path/to/密錀.p12 -S權限.xml 檔案"
 168 .Pp
 169 會使用
 170 .Ar /path/to/密錀.p12
 171 中的私錀來簽署
 172 .Ar 檔案
 173 也會使用在
 174 .Ar 權限.xml
 175 中的權限並把簽署標示為特別用途 (adhoc) 簽署。
 176 .Pp
 177 指令：
 178 .Pp
 179 .Dl "ldid -S權限.xml -M 檔案"
 180 .Pp
 181 會把
 182 .Ar 權限.xml
 183 中的權限加入到已經在
 184 .Ar 檔案
 185 中的權限。
 186 .Pp
 187 指令：
 188 .Pp
 189 .Dl "ldid -e 檔案 > 權限.xml"
 190 .Pp
 191 會把在
 192 .Ar 檔案
 193 中每一部分的權限儲存到
 194 .Ar 權限.xml
 195 。
 196 .Sh 另見
 197 .Xr codesign 1
 198 .Sh 歷史
 199 這個
 200 .Nm
 201 工具程式是由
 202 .An Jay \*qSaurik\*q Freeman 所編寫的。
 203 對iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6號被加入。
 204 .Fl S
 205 在2008年6月13日被加入。
 206 SHA256 支援在2016年8月25日被加入，修正iOS 11支援。
 207 iOS 14支援在2020年7月31日由
 208 .An Kabir Oberai
 209 加入。
 210 iOS 15支援在2021年6月11日被加入。