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 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日被加入。