docs/ldid.zh_CN.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日被加入。