In memory of Ben “bushing” Byer, who passed away on Monday, February 8th, 2016.

Difference between revisions of "/dev/sha"

From WiiBrew
Jump to navigation Jump to search
(Mentioned the special FD)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{stub}}
 
{{stub}}
−
Probably SHA-1 hashing. The device can be accessed either by opening it with IOS_Open or by using the FD 0x10001.
+
'''/dev/sha''' is an IPC interface for the [[Hardware/SHA-1 engine | SHA-1 engine]] that accepts IOS_Open, IOS_Close & IOCTLV commands.
  
−
Accept open,close,ioctlv(0xF(some sort of H0,H1,H2 verifying ),1,3,4)
+
Internally in IOS, it uses 2 FDs: one of 0x10001 normally calculating SHA-1 hashes and 0x10002 when dealing with HMAC key hashes (also based on SHA). Despite this, it is better to do an IOS_Open when using this resource.
 +
 
 +
/dev/sha handles both SHA-1 hashing and HMAC verification in modular IOS versions (IOS28 and later). For monolithic IOS versions (IOS22 and earlier), HMAC verification is done in a dedicated separate device called [[:/dev/hmac]].
 +
 
 +
== /dev/sha IOS_Ioctlv ==
 +
{| class="wikitable" style="margin: 0.2em 0.2em 0.2em 0.2em;"
 +
! style="vertical-align: top;" |number
 +
! style="vertical-align: top;" |Description
 +
! style="vertical-align: top;" |in count
 +
! style="vertical-align: top;" |out count
 +
! style="vertical-align: top;" |vector
 +
! style="vertical-align: top;" |vector length
 +
|-
 +
| style="vertical-align: top;" rowspan="3" | 0x00
 +
| style="vertical-align: top;" rowspan="3" | Initialize Hash Context
 +
| style="vertical-align: top;" rowspan="3" | 1
 +
| style="vertical-align: top;" rowspan="3" | 2
 +
| style="vertical-align: top;" rowspan="1" | input data (64-byte aligned)
 +
| style="vertical-align: top;" rowspan="1" | -
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | SHA-1 Context
 +
| style="vertical-align: top;" rowspan="1" | 0x1c
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | SHA-1 Hash
 +
| style="vertical-align: top;" rowspan="1" | 0x14
 +
|-
 +
| style="vertical-align: top;" rowspan="3" | 0x01
 +
| style="vertical-align: top;" rowspan="3" | Contribute Additional Data
 +
| style="vertical-align: top;" rowspan="3" | 1
 +
| style="vertical-align: top;" rowspan="3" | 2
 +
| style="vertical-align: top;" rowspan="1" | input data (64-byte aligned)
 +
| style="vertical-align: top;" rowspan="1" | -
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | SHA-1 Context
 +
| style="vertical-align: top;" rowspan="1" | 0x1c
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | SHA-1 Hash
 +
| style="vertical-align: top;" rowspan="1" | 0x14
 +
|-
 +
| style="vertical-align: top;" rowspan="3" | 0x02
 +
| style="vertical-align: top;" rowspan="3" | Finalize Hash
 +
| style="vertical-align: top;" rowspan="3" | 1
 +
| style="vertical-align: top;" rowspan="3" | 2
 +
| style="vertical-align: top;" rowspan="1" | input data (64-byte aligned)
 +
| style="vertical-align: top;" rowspan="1" | -
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | SHA-1 Context
 +
| style="vertical-align: top;" rowspan="1" | 0x1c
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | SHA-1 Hash
 +
| style="vertical-align: top;" rowspan="1" | 0x14
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | 0x03
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | 0x04
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
|-
 +
| style="vertical-align: top;" rowspan="1" | 0x0F
 +
| style="vertical-align: top;" rowspan="1" | some sort of H0,H1,H2 verifying
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
| style="vertical-align: top;" rowspan="1" | ?
 +
|-
 +
|}
  
 
[[Category:Wii Filesystem]]
 
[[Category:Wii Filesystem]]

Latest revision as of 21:57, 17 January 2023

This article is a stub. You can help WiiBrew by expanding it.

/dev/sha is an IPC interface for the SHA-1 engine that accepts IOS_Open, IOS_Close & IOCTLV commands.

Internally in IOS, it uses 2 FDs: one of 0x10001 normally calculating SHA-1 hashes and 0x10002 when dealing with HMAC key hashes (also based on SHA). Despite this, it is better to do an IOS_Open when using this resource.

/dev/sha handles both SHA-1 hashing and HMAC verification in modular IOS versions (IOS28 and later). For monolithic IOS versions (IOS22 and earlier), HMAC verification is done in a dedicated separate device called /dev/hmac.

/dev/sha IOS_Ioctlv

number Description in count out count vector vector length
0x00 Initialize Hash Context 1 2 input data (64-byte aligned) -
SHA-1 Context 0x1c
SHA-1 Hash 0x14
0x01 Contribute Additional Data 1 2 input data (64-byte aligned) -
SHA-1 Context 0x1c
SHA-1 Hash 0x14
0x02 Finalize Hash 1 2 input data (64-byte aligned) -
SHA-1 Context 0x1c
SHA-1 Hash 0x14
0x03 ? ? ? ? ?
0x04 ? ? ? ? ?
0x0F some sort of H0,H1,H2 verifying ? ? ? ?
Retrieved from "https://wiibrew.org/w/index.php?title=/dev/sha&oldid=118546"