Skip to content

Commit

Permalink
Manpage updates (#19)
Browse files Browse the repository at this point in the history
* ldid.zh_TW.1, ldid.zh_CN.1: Documents about new -P functionality
and many grammatical, pharsing, formatting and punctuation fixes

* docs: Document setting platform with -P is a Procursus extension

* docs: Document using -arch and -e together
  • Loading branch information
asdfugil authored Jul 23, 2022
1 parent e605d49 commit c629683
Show file tree
Hide file tree
Showing 3 changed files with 109 additions and 62 deletions.
7 changes: 6 additions & 1 deletion docs/ldid.1
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,9 @@ in the special codesign slot at
.Ar num .
.It Fl e
Print the entitlements in each slice, or the slice specified by
.Fl A ,
.Fl A
or
.Fl arch
to
.Ar stdout .
.It Fl H Ns Op Ar sha1 | Ar sha256
Expand Down Expand Up @@ -112,6 +114,9 @@ If
.Ar num
is specified, the platform field in the CodeDirectory will be set to that number.
The default is 13, as per Apple binaries.
Specifying the platform to set to using
.Fl P
is a Procursus extension.
.It Fl Q Ns Ar requirements.xml
Embed the requirements found in
.Ar requirements .
Expand Down
89 changes: 55 additions & 34 deletions docs/ldid.zh_CN.1
Original file line number Diff line number Diff line change
Expand Up @@ -20,25 +20,33 @@
.Op Fl H Ns Op Ar sha1 | Ar sha256
.Op Fl h
.Op Fl I Ns Ar 名称
.Op Fl K Ns Ar 密錀.p12 Op Fl U Ns Ar 密码
.Op Fl K Ns Ar 密钥.p12 Op Fl U Ns Ar 密码
.Op Fl M
.Op Fl P
.Op Fl P Ns Op Ar 数字
.Op Fl Q Ns Ar 需求
.Op Fl q
.Op Fl r | Fl S Ns Ar 档案.xml | Fl s
.Op Fl u
.Op Fl arch Ar 架构类型
.Ar
.Ar 档案......
.Sh 描述
.Nm
把SHA1和SHA256杂凑值加入到Mach-O档案中,
让它们能在有验证但没有签署验证的系统上运行。
.Bl -tag -width -indent
.It Fl A Ns Ar 处理器类型 : Ns Ar 亚类型
当和
.Fl a , Fl D , Fl e , Fl h , Fl q ,
.Fl a
.Fl d
.Fl e
.Fl h
.Fl q
.Fl u ,
.Fl u
一起被使用时,只作用在被
.Ar 处理器类型
Expand All @@ -55,7 +63,7 @@
.Fl A
一样,不过使用架构的名称。
已知的
.Ar 架构类型 Ns s
.Ar 架构类型 Ns
可以在
.Xr arch 3
中找到。
Expand All @@ -76,10 +84,13 @@
.Ar 数字
的特殊代码签署位置中。
.It Fl e
把每一部分的权限印出, 或印出
.Fl A ,
所指定的部分的权限
.Ar 到标准输出。
把每一部分的权限印出,或印出
.Fl A
.Fl arch
所指定的部分的权限到
.Ar 标准输出
.It Fl H Ns Op Ar sha1 | Ar sha256
禁用没有指明的杂凑吗。
这个选项可以用来重现
Expand All @@ -88,26 +99,35 @@
.It Fl h
印出关于签署的资讯,包括杂凑值的
类型,选项,CDHash, 和 CodeDirectory 版本到
.Ar 标准输出。
.Ar 标准输出
.It Fl I Ns Ar 名称
把二进制档案签署中的识别码设定为
.Ar 名称。
.Ar 名称
如没有指明,就会使用二进位档案的档案名称。
.It Fl K Ns Ar 密錀.p12
用在
.Ar 密錀.p12 .
的身份签署。 会给二进位档案有一个有效的签署,令它能够在有签署验证的系统上运行。
.It Fl K Ns Ar 密钥.p12
使用位于
.Ar 密钥.p12
的身份签署。会给二进位档案有一个有效的签署,令它能够在有签署验证的系统上运行。
如果
.Ar 密錀.p12
有密码的话,你会被询问。 也可以用
.Ar 密钥.p12
有密码的话,你会被询问。也可以用
.Fl U
选项来提供密码。
.It Fl M
当和
.Fl S ,
一起使用时,和现有的权限合并而不是取代它。 在加入权限时有用。
.It Fl P
将这个Mach-O二进位档案标示为系统二进位档案。
.Fl S
一起使用时,和现有的权限合并而不是取代它。在加入权限时有用。
.It Fl P Ns Op Ar 数字
将这个Mach-O二进位档案标示为平台二进位档案。
如果提供了
.Ar 数字
,那么在CodeDirectory中的平台区域定会被设定为该数字。
根据苹果的二进位档案,预设为13。
使用
.Fl P
来设定平台是一个Procursus扩展。
.It Fl Q Ns Ar 需求
把需求嵌入到
.Ar 需求
Expand Down Expand Up @@ -144,46 +164,47 @@
.Pp
指令:
.Pp
.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -Sent.xml 档案"
.Dl "ldid -Cadhoc -K/path/to/密钥.p12 -S权限.xml 档案"
.Pp
会使用
.Ar /path/to/密錀.p12
.Ar /path/to/密钥.p12
中的私錀来签署
.Ar 档案
也会使用在
.Ar ent.xml ,
.Ar 权限.xml
中的权限并把签署标示为特别用途 (adhoc) 签署。
.Pp
指令:
指令
.Pp
.Dl "ldid -Sent.xml -M 档案"
.Dl "ldid -S权限.xml -M 档案"
.Pp
会把
.Ar ent.xml
.Ar 权限.xml
中的权限加入到已经在
.Ar 档案 .
.Ar 档案
中的权限。
.Pp
指令:
指令
.Pp
.Dl "ldid -e 档案 > ent.xml"
.Dl "ldid -e 档案 > 权限.xml"
.Pp
会把在
.Ar 档案
中每一部分的权限储存到
.Ar ent.xml .
.Ar 权限.xml
.Sh 另见
.Xr codesign 1
.Sh 历史
这个
.Nm
工具程式是由
.An Jay \*qSaurik\*q Freeman . 所编写的。
.An Jay \*qSaurik\*q Freeman 所编写的。
对iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6号被加入。
.Fl S
在2008年6月13日被加入。
SHA256 支援在2016年8月25日被加入,修正iOS 11支援。
iOS 14支援在2020年7月31日由
.An Kabir Oberai .
.An Kabir Oberai
加入。
iOS 15支援在2021年6月11日被加入。
75 changes: 48 additions & 27 deletions docs/ldid.zh_TW.1
Original file line number Diff line number Diff line change
Expand Up @@ -22,23 +22,31 @@
.Op Fl I Ns Ar 名稱
.Op Fl K Ns Ar 密錀.p12 Op Fl U Ns Ar 密碼
.Op Fl M
.Op Fl P
.Op Fl P Ns Op Ar 數字
.Op Fl Q Ns Ar 需求
.Op Fl q
.Op Fl r | Fl S Ns Ar 檔案.xml | Fl s
.Op Fl u
.Op Fl arch Ar 架構類型
.Ar
.Ar 檔案......
.Sh 描述
.Nm
把SHA1和SHA256雜湊值加入到Mach-O檔案中,
讓它們能在有驗證但沒有簽署驗證的系統上運行。
.Bl -tag -width -indent
.It Fl A Ns Ar 處理器類型 : Ns Ar 亞類型
當和
.Fl a , Fl D , Fl e , Fl h , Fl q ,
.Fl a
.Fl d
.Fl e
.Fl h
.Fl q
.Fl u ,
.Fl u
一起被使用時,只作用在被
.Ar 處理器類型
Expand All @@ -55,7 +63,7 @@
.Fl A
一樣,不過使用架構的名稱。
已知的
.Ar 架構類型 Ns s
.Ar 架構類型 Ns
可以在
.Xr arch 3
中找到。
Expand All @@ -76,10 +84,13 @@
.Ar 數字
的特殊代碼簽署位置中。
.It Fl e
把每一部分的權限印出, 或印出
.Fl A ,
所指定的部分的權限
.Ar 到標準輸出。
把每一部分的權限印出,或印出
.Fl A
.Fl arch
所指定的部分的權限到
.Ar 標準輸出
.It Fl H Ns Op Ar sha1 | Ar sha256
禁用沒有指明的雜湊嗎。
這個選項可以用來重現
Expand All @@ -88,14 +99,16 @@
.It Fl h
印出關於簽署的資訊,包括雜湊值的
類型,選項,CDHash, 和 CodeDirectory 版本到
.Ar 標準輸出。
.Ar 標準輸出
.It Fl I Ns Ar 名稱
把二進制檔案簽署中的識別碼設定為
.Ar 名稱。
.Ar 名稱
如沒有指明,就會使用二進位檔案的檔案名稱。
.It Fl K Ns Ar 密錀.p12
用在
.Ar 密錀.p12 .
使用位於
.Ar 密錀.p12
的身份簽署。會給二進位檔案有一個有效的簽署,令它能夠在有簽署驗證的系統上運行。
如果
.Ar 密錀.p12
Expand All @@ -104,10 +117,17 @@
選項來提供密碼。
.It Fl M
當和
.Fl S ,
.Fl S
一起使用時,和現有的權限合併而不是取代它。在加入權限時有用。
.It Fl P
將這個Mach-O二進位檔案標示為系統二進位檔案。
.It Fl P Ns Op Ar 數字
將這個Mach-O二進位檔案標示為平台二進位檔案。
如果提供了
.Ar 數字
,那麼在CodeDirectory中的平台區域定會被設定為該數字。
根據蘋果的二進位檔案,預設為13。
使用
.Fl P
來設定平台是一個Procursus擴展。
.It Fl Q Ns Ar 需求
把需求嵌入到
.Ar 需求
Expand Down Expand Up @@ -144,46 +164,47 @@
.Pp
指令:
.Pp
.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -Sent.xml 檔案"
.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -S權限.xml 檔案"
.Pp
會使用
.Ar /path/to/密錀.p12
中的私錀來簽署
.Ar 檔案
也會使用在
.Ar ent.xml ,
.Ar 權限.xml
中的權限並把簽署標示為特別用途 (adhoc) 簽署。
.Pp
指令:
指令
.Pp
.Dl "ldid -Sent.xml -M 檔案"
.Dl "ldid -S權限.xml -M 檔案"
.Pp
會把
.Ar ent.xml
.Ar 權限.xml
中的權限加入到已經在
.Ar 檔案 .
.Ar 檔案
中的權限。
.Pp
指令:
指令
.Pp
.Dl "ldid -e 檔案 > ent.xml"
.Dl "ldid -e 檔案 > 權限.xml"
.Pp
會把在
.Ar 檔案
中每一部分的權限儲存到
.Ar ent.xml .
.Ar 權限.xml
.Sh 另見
.Xr codesign 1
.Sh 歷史
這個
.Nm
工具程式是由
.An Jay \*qSaurik\*q Freeman . 所編寫的。
.An Jay \*qSaurik\*q Freeman 所編寫的。
對iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6號被加入。
.Fl S
在2008年6月13日被加入。
SHA256 支援在2016年8月25日被加入,修正iOS 11支援。
iOS 14支援在2020年7月31日由
.An Kabir Oberai .
.An Kabir Oberai
加入。
iOS 15支援在2021年6月11日被加入。

0 comments on commit c629683

Please sign in to comment.