docs/ldid.zh_TW.1

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