635 lines
94 KiB
Plaintext
635 lines
94 KiB
Plaintext
|
!<arch>
|
|||
|
|
/ 0 0 0 0 542 `
|
|||
|
|
Jî Jî Jî Jî Jî Jî_ZN60_$LT$getrandom..error..Error$u20$as$u20$core..fmt..Debug$GT$3fmt17h23303fe9eaec5683E _ZN62_$LT$getrandom..error..Error$u20$as$u20$core..fmt..Display$GT$3fmt17h64d54a1141a180f0E _ZN9getrandom8backends27linux_android_with_fallback17use_file_fallback17h5c8b490a7fa5717fE _ZN9getrandom8backends27linux_android_with_fallback4init17h853cfed7d4b82fa7E _ZN9getrandom8backends27linux_android_with_fallback12GETRANDOM_FN17h998e1e21b1cddb0bE _ZN9getrandom8backends8use_file9util_libc13last_os_error17h8f0783e507f428b2E // 68 `
|
|||
|
|
getrandom-ee9662acccf8949d.getrandom.1ff86f8ad0085eb8-cgu.0.rcgu.o/
|
|||
|
|
lib.rmeta/ 0 0 0 644 83920 `
|
|||
|
|
ELF · PF @ @ GNU À rust
|
|||
|
|
ÏC #rustc 1.96.0 (ac68faa20 2026-05-25)ÁíàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ cfg_ifÁŸ=�ê @Êq{0¡¡£ª -c28393f1568b0153Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ–� `ãŒN€ZÛ:õ\ -7ce82f3507212cabÁ ‰À % »À| error_std_implsÁ|£»À|�0 inner_u32ÁLüú androidÁ¬·ú linuxÁœÎü¶,ü²10 inner_u64ÁL‡ú³=úÆ64130ç$ö ú³¬Ã úÆœÚ ü ,ü¾ 1 í _ backendsÁ errorÁ UNSUPPORTEDÁ ERRNO_NOT_POSITIVEÁ
|
|||
|
|
UNEXPECTEDÁ INTERNAL_STARTÁ CUSTOM_STARTÁ from_neg_error_codeÁ raw_os_errorÁ
|
|||
|
|
new_customÁ new_internalÁ
|
|||
|
|
internal_descÁ × × utilÁ slice_assume_init_mutÁ ¥ uninit_slice_fill_zeroÁ slice_as_uninitÁ ¥ slice_as_uninit_mutÁ "¥ ptr_from_mutÁ $¥ ¼ &¥ › ß truncateÁ fillÁ fill_uninitÁ Ô Ú use_fileÁ 0 0000000 util_libcÁ 8 88
|
|||
|
|
last_os_errorÁ 8 sys_fill_exactÁ < 0impl Fn(&mut [MaybeUninit<u8>]) -> libc::ssize_tÁ < 0 FILE_PATHÁ 0 FD_UNINITÁ 0 FD_ONGOING_INITÁ 0 FDÁ 0
|
|||
|
|
fill_innerÁ C 0
|
|||
|
|
open_readonlyÁ 0 open_or_waitÁ 0 open_fdÁ 0ç H HHHHHH waitÁ H wakeÁ H wait_until_rng_readyÁ linux_android_with_fallbackÁ R RRRRRRRRR R
|
|||
|
|
R R R
|
|||
|
|
RRRR GetRandomFnÁ R
|
|||
|
|
NOT_AVAILABLEÁ R GETRANDOM_FNÁ R initÁ g NAMEÁ R use_file_fallbackÁ RÏ j sanitizerÁ l l unpoisonÁ l unpoison_linux_getrandom_resultÁ 88 get_errnoÁ
|
|||
|
|
RawOsErrorÁ NonZeroRawOsErrorÁ ErrorÁ u
|
|||
|
|
uˆ zƒ |Ö �
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
"
|
|||
|
|
$
|
|||
|
|
&
|
|||
|
|
,
|
|||
|
|
-
|
|||
|
|
<
|
|||
|
|
<
|
|||
|
|
C
|
|||
|
|
E
|
|||
|
|
i
|
|||
|
|
j
|
|||
|
|
n
|
|||
|
|
o
|
|||
|
|
{
|
|||
|
|
}
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
Š u u vË
|
|||
|
|
wˆ Éo„ºW·n
|
|||
|
|
Ûþ Øþ ™þ Ðìþ µßþþ ¿cþ Äcþ x uy uz u| u~ u u u uŠ (ÛØ™Ðìµß¿cÄc ü�© ” Uÿ!,
|
|||
|
|
|
|||
|
|
t” ¡ 4» Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
þ Â — ‡ D· l· À * ¾
|
|||
|
|
’" Õ
|
|||
|
|
ÑÛÑÛ MaybeUninitÁ ÓÛ uninitÁÝ ÔÛ»Ý Íõƒ«%9 ¯ © à <í h - ´� • · ìˆ |ʸ
|
|||
|
|
; ó øw”4
|
|||
|
|
ü”3 ¤” 1‘Ád ¥ , ] LÎ ÿÿÿÿÿÿÿÿÿ ü²' ”² ² 7 ô ô õ ¨ ÷ ˆÐ mjç�ítoé t¶ 0 ý×�%E* 0 7 Ê LË& )1 ) 1 0 Ï Ê %)1 Ø D÷ Ö¿…þ ‘ 7 Ÿ � H ò à üíÖ I‘ád i‘Þd Ö¿ Ê€“€“ �“ TryFromIntErrorÁ ‚“ˆ Z} Ràvq ‘êd ‘Âe ô©
|
|||
|
|
’� « Ê -˜� Ö¿ Êþ @ Æ � –
|
|||
|
|
ù¶ « Ê Åÿ¶
|
|||
|
|
•¢ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ˆê )?ÈXM´ þÊ : A wÇ ü”4
|
|||
|
|
l Ê È
|
|||
|
|
øyà, üà+ ”à mºž,
|
|||
|
|
# ]õ�- u‚ž- Q�ž¿!" " " ª ¦ Uµ� Ö¿Êþ à þ Ø ™ ' .
|
|||
|
|
©· þ 5·
|
|||
|
|
Ö¿š þ Õ¯·
|
|||
|
|
•¢ÌÊ
|
|||
|
|
È· › ¢ a xÇ
|
|||
|
|
|
|||
|
|
[ Ì Ç& Î( EÔº &
|
|||
|
|
uκ ( & É ¥ # (
|
|||
|
|
ïº '
|
|||
|
|
þ •õº Ö¿…þ ' F( M& ì
|
|||
|
|
3
|
|||
|
|
ýÃp8- -àp-! ! $ %% m- $ ! � ý‘&- % $ ý¿.- € % # h% n$
|
|||
|
|
úp-! ý½p>- ý¸pD- Û¼þ
|
|||
|
|
ûp-
|
|||
|
|
©q- w ž# ¥ Äó)
|
|||
|
|
²†1 ) Û þ -¸†1! Ö¿ þþ ) @) Š * + ö" * « þ ó# •¢ Ìþ * U+ \* y‹ üà, l þ Œ š í a ˆ# � ê) EÓ†1 Ö¿þþ þ ) Ü ï* ö+ 8" + þ 5$, <$ , Ö¿š þ + 3$ •¢Ìþ , 0$, X+ _* z‹ [ Ì „ - ‹ / -% - *% / - ¥ J% / (% . þ %& Ö¿…þ . ø / ÿ - ƒ
|
|||
|
|
�ãÀ!" mïn- ù�¯À$! # ." ½·o- üÈ&À ) l½' )2
|
|||
|
|
„’. 0 €€€€ ]�’.
|
|||
|
|
ÌÙ 3 "/ ¤( 4 6 )ˆúˆ5- 2 0 9ˆÛŸ5, Û¼Ê 2 Œ)2 ‡( )1 À 0 u�M"05 )ðÔÞ"36 3 6 Û Ê yðÔÞ"3 5 6 Ê ðâÞ"36 }€M"0 5
|
|||
|
|
ŽM"05 Œ
|
|||
|
|
!)2 üÿ&‰ ) £)1 a 0 ¡05 A05 Ê
|
|||
|
|
< 4¨ ü‰ üæµ üŠ‘ Ã Ê Ñ 7 ² ¹ À È
|
|||
|
|
üÀà ýÐ!D, Ûs�T˜ ù‘÷cÚ ‘æ –
|
|||
|
|
ýð‹à ç[Êäþ >öÊ äþ …Ô u�� ¥«� ¬± >öʉ,…-¹�ý–¶Ä ÷\Êþƒ
|
|||
|
|
ýö¶! ý¥·$ ý°��, þs�—£—£ » ™£¹ < =áï_å Êtä ý¨�n- Ík�Pý¨nˆ- ²k�Gù��¼á! ¹Õ ýÿn(-ý¨Ç- üj�¿ý£Ì- ýþq- ý�º— ü\…þþƒ
|
|||
|
|
åëº ýáè$W † þmùº ýÄ…¨1 ÆTþþa …†1 Y ÷\þþH T" "P" "Œ ü\…þþo †% %‚& † þ}%ü² æ M üì ¬ ( (ýéx› E( ·
|
|||
|
|
Ê,þ (ùˆÂž¬5) ôÉ R(ùˆÿžo5+ +ùˆÄ‡Û5+ ¯Ê ‰ˆ‘Ÿ5+ýÔ‘x- Æ ùˆˆˆ'5-, Æ ¹ˆ³Ÿ5+ýÔLA" ¸ßۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙʳ1ù
|
|||
|
|
ýê‘Ç10 ³UÊM†M"0õ”“11 1ùð¯Þ6"2 šà Eª“11 8· Œõ þ <� ö D´ € Y ¥ ± ö ( ü < þ D ¥ æ ý •¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜ÌÊ ƒ
|
|||
|
|
Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Êþ �
|
|||
|
|
Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Êä –
|
|||
|
|
Ì ú
|
|||
|
|
Ê a •¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜Ìþ š Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
þþ é ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙþ -
|
|||
|
|
Ì Û þ Ä ù
|
|||
|
|
³1 Ê n
|
|||
|
|
ž
|
|||
|
|
Ê 4 Ê Ì Ê
|
|||
|
|
þ Ê Ì º Ê t
|
|||
|
|
[þ < € Ã ¦8 Á ‚
|
|||
|
|
Ê ù�¦À/!¡! ½ ¡! ‚-¥ 5ëº þ [ Ž þ : þ
|
|||
|
|
" þ T
|
|||
|
|
"Ì D
|
|||
|
|
"¥ :% þ ‘ % Ä % Ê $ð ( h (Ê s- … µ. … ½/ E0Ê D3˜
|
|||
|
|
bufÁ¨ sys_fillÁµ resÁ² ™9— ™9£ ‘ Ž Ž œ
|
|||
|
|
|
|||
|
|
¹Ô
|
|||
|
|
Ž ‡
|
|||
|
|
¹”
|
|||
|
|
errÁ¿ * Œù þ\Í Û/ ÊŒ“ þŒµ þIˆ¥ˆ5 ÆÉ ÊIˆÃˆ5 ÆÉ Ê ö
|
|||
|
|
ð< ë^
|
|||
|
|
ö
|
|||
|
|
ö
|
|||
|
|
|
|||
|
|
Ús�nþ+
|
|||
|
|
Ï� †< †<]Ão-þ
|
|||
|
|
ë†1 ¤(
|
|||
|
|
¤(%
|
|||
|
|
ŒÈ Û¼Ê Á Û/ Ê # 1 < × ³1 N ³1 U \
|
|||
|
|
Û/ Ê þ Æ > ± þ ´ þ+ Æ ä ² ×Y þ Œì ÐÊ
|
|||
|
|
5 B
|
|||
|
|
Ð ü üÓ+ ? ó> ,ä Å> Š Å> ‘ 2 b"/dev/urandom\0"Á ÿÿÿÿÊ -1Á þÿÿÿÊ -2ÁÌÙ TÙ —Õ Ê Ë4Ì4Í4
|
|||
|
|
__variant1Á Î4Ï4
|
|||
|
|
__variant2Á �ë ò g üÂ1
|
|||
|
|
|
|||
|
|
´Â
|
|||
|
|
ž¢@ ‘ + ò ü’d e ‰‰ § ‹‰ ï íe¼îËè¿*¢@ |§ ¡@ ù Yó —Õ Ê _Á dÜ ¤]¤] V ¦]Á‚] üß3ø¤”&¡@ ¼é m«±
|
|||
|
|
%©¯“ î0î0
|
|||
|
|
UnsafeCellÁ ð0»Ì- ·}—KEüC£™]™] š] Align8Á œ]ˆ‹] ̲ˆ364¥¡@ �
|
|||
|
|
¡@ ýŸ±!
|
|||
|
|
þ]¡@
|
|||
|
|
¾ ¼À½À¾ÀË ¿ÀÀÀÌ ÁÀÂÀG ÃÀÄÀF ÅÀÆÀ× `šÁ¬S øB -º± ¢ â ¬ì m®¤% %®¤%
|
|||
|
|
ýÕ€$% ¡@
|
|||
|
|
º¤% ý®¤ % ÿÿÿÿÿÿÿÿ¡@
|
|||
|
|
̤% t ¼Œ
|
|||
|
|
i $ž d£ ü» / ¡@Ê¥ ü– µ
|
|||
|
|
k €¥ €G š üö Ö
|
|||
|
|
< k¸G»GÑG $� ƒ 4 Ë Ñ üéé Ô
|
|||
|
|
¿±
|
|||
|
|
ë ¬— Uõ Z
|
|||
|
|
ýã1!Z
|
|||
|
|
Ê mžT%
|
|||
|
|
|
|||
|
|
4Õ
|
|||
|
|
g 5
|
|||
|
|
ý…U#% uœM% ÁA ý€U)% Û¼ÁA
|
|||
|
|
¨U% ¼ Û ÁA  j üáó üΆ ü†Î d· üŸ ³ ýœ°¬ Ü]¢@ý ýùM ï]¢@E°±ý‚ß“ û0ÇC-þ¹ýØ>O ÂÇC¡@5„ºýâSù% Ÿ¢@s ýšNO Á¢@M¢T% ý´'CO
|
|||
|
|
È¢@eÌO
|
|||
|
|
ý¶ìZ
|
|||
|
|
Ú¢@MÙO
|
|||
|
|
ýå½Z ùý¬Þ[
|
|||
|
|
½Ý ùý“á4 ý¥.çZ âÐ5ù Zý˜@Z ÛÐ…e÷1Zý”J¦% ž¢@ÅŽU% ý¬*ñF š 9œî$Fù�¬Þ[ ÿÝ ù�“á4ý�¤R% û¢@ ý†~û% ª¢@E³¤% ª¢@EŤ% · Œ” þ $ó ¡@ <Ò ¸B ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÁA ÁA † Ç €G (ûG
|
|||
|
|
ÓG ŽD 7 �C 婯“ÁA Ê c¡@ ÁA destÁË raw_ptrÁÖ fptrÁ$Š » getrandom_fnÁÅ lô e ÁA ¨I³ ÔF
|
|||
|
|
öGs ¥DK
|
|||
|
|
¼Ý 霈%F = E e ÁA P ^ j p ÁA { ÁA ‚ ‰� e ÁA d» ÓG ¼È %ôÈ, M‡O ¡@ Lá ü» 3 G # ‡G ì . í ž
|
|||
|
|
ž
|
|||
|
|
¥ ž
|
|||
|
|
Ë 4 Ê ¹ 8 8 Ê 8 ¹ Œô œ
|
|||
|
|
ü§É œ
|
|||
|
|
l®
|
|||
|
|
|
|||
|
|
>
|
|||
|
|
>
|
|||
|
|
>
|
|||
|
|
k ø ü± š ý½ÈW, …t�dÌ
|
|||
|
|
Â�¢@4Ù ü�è o üü 4 ü�Ù üÛ• ü®8 * ‘æ ¤ˆ‡ þs�«£«£ à £þ ôÉûT™göÊÄÂýÛ“b- Äk� ƒ
|
|||
|
|
²k�u©”-
|
|||
|
|
‚ ¹Õ { x üj�è t
|
|||
|
|
|
|||
|
|
p
|
|||
|
|
üÐ÷ n ŒÇô© ¥ › ûG N þ — €G ¡@ ÷ Ê Ö ÓG w ¦8 …ôÈ, ž
|
|||
|
|
Ê 4 > 8 ò8T ¡OÝ ÓG retÁ µ Ö †<G €G= †<Y _ref__getrandom_fnÁ Ç n þ ð … ƒ þ ç ò8 .
|
|||
|
|
ê ž
|
|||
|
|
ž
|
|||
|
|
¥ ž
|
|||
|
|
õ üí‰ ÷ ø
|
|||
|
|
4 4 Ê M Ö¿ Êä ® ¹ l÷ « Ê ä¾ ? 8 8 Ê 8 ¹ é
|
|||
|
|
Ío-
|
|||
|
|
è ò
|
|||
|
|
ò
|
|||
|
|
|
|||
|
|
¡! 9 € \
|
|||
|
|
e w Û¼þ “ œ <³ Û þ ï ‘ º
|
|||
|
|
œ ` ¥
|
|||
|
|
|
|||
|
|
> á
|
|||
|
|
è
|
|||
|
|
>
|
|||
|
|
> o { n j f N ‘æ c þs�™V3 1 Äk�c ²k�-z ¹Õ �• üj�è¬ ¸
|
|||
|
|
* n ' % … æ þ ¾ ¥ Û Ñ4
|
|||
|
|
Ê …ë6 v þ › ž
|
|||
|
|
Ê 4 >Ê $þ e¦8 è¦8 ò 8¡! ò8z ×W~
|
|||
|
|
bytes_writtenÁ writtenÁ% ÷ †<£ (GŠ G� { ! & þ 2 þ < E O H“ } H‘ … ˆb $ . %¥8E ˜ U Ê
|
|||
|
|
®8E -³8E ˜ U Ê
|
|||
|
|
½8E > Iž € HI• ýø7LE …
|
|||
|
|
ʈI² š ·
|
|||
|
|
Ê-ª8Eš ·
|
|||
|
|
Ê-¹8E¦ šà Í¥8E a ˆb h ˆb o Ê U¥8E˜ Ê ]³8E˜ æ › ¹
|
|||
|
|
¨ ² ¬µ
|
|||
|
|
”µ
|
|||
|
|
È
|
|||
|
|
0 ü– 5 þ , $ _Á ¬»
|
|||
|
|
|
|||
|
|
”»
|
|||
|
|
Úe Î
|
|||
|
|
ëe
|
|||
|
|
. ü•
|
|||
|
|
<
|
|||
|
|
þ ,³
|
|||
|
|
$ _Á ¬Å
|
|||
|
|
”Å Úe Ø ëe
|
|||
|
|
. ü§4 þ ,½ $ _Á <¾ à ʇG ) ‡G 9 ¾ ÊI Ê e * Êq Ê ü›+ Ê T± ‡G ° ¶ 1 _Á < ² ʇG ) ‡G 9 ÊI Ê e * Êq Ê üŒ)
|
|||
|
|
Ê T ‡G ° ¶ 1 _Á 4÷ ˜ U Ê ‚ h h Ê h $ç& ³1 h s } €€€€ ˜( s � • ¤( • • ¤( • Ï á Û¼Ê ùˆ°Ÿ45 !ˆÍŸ5 ³1 ) ~ � š ·
|
|||
|
|
ʬ ² ôÉ s Ê Ø ¯Ê ëõ Æ õ Æ ³1 ”Ï þ $Æ Ê Ñ ˜ Þ h Ê Ï … • … • : codeÁ ~ ÆÉ Ê
|
|||
|
|
ÆÉ Ê ¤(• ¤(• Œ * Ê üŠ*' Ê °* üÁ*1 üÊ*& eØfE ýïb"E ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ˜ ` •ÒfE ¥ !
|
|||
|
|
øfE Û ˜
|
|||
|
|
ßjE ¾ ü»*8 u ò* ù* üð(‰ üÿ)z ý˜fÎE ´
|
|||
|
|
Ê eófE ýŒa�E ³
|
|||
|
|
Ê.ò š 9íî$Fî ÿÝ è þ ,“) ëe ˆ) Ê $ƒ* Ê Ç ˜ “ êp ‰¥ =ófE 0 ¹> ¿nB ÐœŠ*
|
|||
|
|
Ê
|
|||
|
|
¡” éíˆ%F r 6 ¡* P Ê + P d
|
|||
|
|
Ê J I $ë* Z
|
|||
|
|
büÊ*
|
|||
|
|
´
|
|||
|
|
Ê 6 … ï* Î u Ì ø* Ó Ò Ï þ q ëe p Ê o Ê 5 ëe ˜ Ê Á ¹¢ ¿n§ 6g
|
|||
|
|
Ê Œ�- Ê üø,) Ê - ü±-1 üº-& ‡ … êp � > K ¥ ^ > Û ˜ < q ü«-8 u â- é- üÓ+– üí,| : ´
|
|||
|
|
ÊÆ 5 3 ³
|
|||
|
|
Ê]! š / ÿÝ þ ,ÿ+ ëe ô+ Ê $ñ, Ê k ˜ 7 êp ´¥ + Y ¹< ¿n@ ¿¬ø, Ê Ÿt% h Ð ‘- ê Ê Å ê \ Ê ä ã $Û- ô
|
|||
|
|
üüº- ºu 0 ß- ¯ u è- ´ ³ ° þ a ëe ` Ê _ Ê É ëe ú ˜ œ Ê º ¹‘ ¿n– X Ê ü‘' ö ü‘3
|
|||
|
|
¥ à L£ ° ü°€ ü‡© üÀ 9 $
|
|||
|
|
ÑÛÑÛ � ÓÛ¢Ý ÔÛ»Ý Íõƒ«%9Ì}¸ Ë} Dø œ~ ,× Ê}  œ~ â ž µ ‹ ¬ Ôä
|
|||
|
|
üä
|
|||
|
|
3 ‚ – Lö ƒ " ü…
|
|||
|
|
þ üÚ
|
|||
|
|
©
|
|||
|
|
$Ë}o ï~ ¬¾
|
|||
|
|
ã~ ,ª
|
|||
|
|
‚ u Ê} ‘ ž µ Þ
|
|||
|
|
c Ê ù $ ‡ Ì} 4é Ì} Û ½ ·
|
|||
|
|
<î Õëƒ? ÑÛÑÛ � ÓÛ¢Ý ÔÛ»Ý Íõƒ«%9‡G %–Ë?
|
|||
|
|
*
|
|||
|
|
|
|||
|
|
¡! ýÃ')^ €
|
|||
|
|
Ê ýù=.b Ànõ ¼õ
|
|||
|
|
Ô¥
|
|||
|
|
|
|||
|
|
j $º ' ™ Øt¥ %㶠Uݶ ¸ þ B t¿ ª Ö¿ õ>þ ¼
|
|||
|
|
Ë Ñ ¸" þ Ð$ Ð$ Ö¿š þ õ$ •¢ÌÀ„ $ 3 : nŒ oŒ [ Ì a h X) f) ¥ f) ’) þ ª* Ö¿‡Gþ Õ Ü � ˜ ¨ $¨ g üµ! ù ÷! ö õ> ð ï
|
|||
|
|
D ü©0 Ö¿ À„þ
|
|||
|
|
k
|
|||
|
|
{ ‚
|
|||
|
|
" « À„ 9
|
|||
|
|
# •¢ ÌÀ„ ½ Ä Š Äõ l À„ ¥ äú ƒ ý‡ä#?% ½‡ä?%
|
|||
|
|
% ÃÛÃÛ ManuallyDropÁ ÅÛ»¬ „ µÜÀ,�%*‡G MÉZ& ‡G
|
|||
|
|
©ä?% ýàÕ%N(
|
|||
|
|
°ä?% “ ü÷ Ö¿ ‡Gþ – ô › ( ,ü»Þ üê¯ üÖà üñ~ Ó Ú á ` ý¹ƒR? ò‡Gäø ýúɺ? ö‡Gd“ P ‡G�4 ýÞjKX À‡GÜÍ ýí7Âb îr �ü°9 ¥ š 9™î$F ¡
|
|||
|
|
ÿÝ ›
|
|||
|
|
U À�uè;b ý»•MX Ê�}—<b ýïÁtN Æ�ýÿ=(b ýµ&¹^ º€�íÄÂNü´§ - ; u¿
|
|||
|
|
Ü¥ 8 Ûs�T�Ñ ÷\…þ9ë ÷ à ü\À„þþcà ë † þý f ÐÚo m $€ä Ñ ÷\À„þ ë" "÷" "ýÕàì? ÷‡Gl‡ m!% ÛɇG]Ÿä?%ýµ‚³Z% …‡G5«ä?%ý¨ÃåN' ݇GUÖƒZ'à ü\‡Gþþ¦ à) )ë* † þý) Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
‡Gþ ”Ñ ò� Ú þ † ¡! õ•¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜ÌÀ„ � Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
À„þ á Ì ¨ À„ )‡G ò� ò� u–Ë? ¦8 · À„ (¥ -ö¶ þ ¸¾‡ ¦8 < À„
|
|||
|
|
" þ ¸"Ì Ð"‘Š a% É a%¥ â) þ ’) f) ™9Z dstÁ Ú »Œ Ž „ ¹ ìý‡k X �‡G Ê �� Êýå•!X ‚� Ê
|
|||
|
|
ŽÏ 陈%F ¶ƒ †<n
|
|||
|
|
LJGýªâ#?
|
|||
|
|
<š
|
|||
|
|
ÑÛÑÛ � ÓÛ¢Ý ÔÛ»Ý Íõƒ«%9
|
|||
|
|
|
|||
|
|
,"
|
|||
|
|
|
|||
|
|
¡!
|
|||
|
|
€
|
|||
|
|
Ê ÿ Àp¡ ¼¡
|
|||
|
|
ü
|
|||
|
|
¶ƒ û !
|
|||
|
|
Å û ù ö ¸ þ 5
|
|||
|
|
ô ª Ö¿À„þ °
|
|||
|
|
¿ Å ¸" þ Ð$ Ð$ Ö¿š þ õ$ •¢ÌÀ„ $ ' . p¸ q¸ [ Ì U \ X) f) ¥ f) ’) þ ª* Ö¿þ É Ð ¹ Ä � $˜ W ð ç å! ä ¾‡ Ý Ü
|
|||
|
|
1
|
|||
|
|
î Ö¿ À„þ
|
|||
|
|
[
|
|||
|
|
k r
|
|||
|
|
" « À„ 9
|
|||
|
|
# •¢ ÌÀ„ ´ † Ä¡ l À„ ¡ ä¦ ¯ ì % è % ï % ÃÛÃÛ Ïˆ ÅÛ»¬ „ µÜÀ,�%* Û & Ù % Ö ( Ò % ¿ ü£ Ö¿ þ Â Ó o ) ,üçÞ ü–¯ ü‚à ü�~ ² ¹ À C Ï òä¤ Ë öd¿ "% Â�4Ì Æ ÀÜù à îr �üÜ9 & š ¿ +&
|
|||
|
|
ÿÝ =&
|
|||
|
|
|
|||
|
|
À�¼ º Ê�¶ ´ Æ�° º€�© ¦ - â £ « ³ £ 8 Ûs�¢ Ñ ÷\…þÚë ÷ à ü\À„þþà ë † þý Ð{
|
|||
|
|
$€… Ñ ÷\À„þ» ë" "÷" "¡ ÷l³ ß%% Û©�œ %™ % …” %‘ ' ÝŒ 'à ü\þþ3 à) )ë* † þý) Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
þ ”ý ÷• [ þ P ¡! ¡Æ‘ Í Ÿ’ Í Ì À„ % ÷• ÷• è ¦8 õ · øÀ„
|
|||
|
|
¥ å þ ¸¾‡ ÿ ¦8 À„
|
|||
|
|
" þ ¸"Ì Ð"ê� C% ©� C%¥ â) þ ’) f) ™94 º“ † »ã Ž s ¹û üß � Êï �� ÊÝ ‚� Ê «•Ö ¶ƒí †<n
|
|||
|
|
ÇÒ ørõ8 üõ7 üŠ ! ¦8
|
|||
|
|
B Q
|
|||
|
|
n
|
|||
|
|
n
|
|||
|
|
|‹ » # ü‡@ 5 ½ Æ ¶ƒ ¼ â © § ¤
|
|||
|
|
¾‡
|
|||
|
|
Y Ö¿ À„þ
|
|||
|
|
\
|
|||
|
|
m t
|
|||
|
|
« À„ 9
|
|||
|
|
•¢ ÌÀ„ ¯ ¶ r¬ üõ8 l À„ s¬ 4³ · ~ ¸
|
|||
|
|
þ ú ¹ ª Ö¿À„þ
|
|||
|
|
N
|
|||
|
|
_ f ¸ þ Ð Ð Ö¿š þ õ •¢ÌÀ„ É Ð ú [ Ì ò ù X f ¥ f ’ þ ª Ö¿…þ f m ‡ ë R ó , üŸœ É Ð × ü o "Ðà w $õ>äß - ô Ü ä ì Ü 8 Ûs�ÛÑ ÷\…þë ÷ Ã
|
|||
|
|
ü\À„þþ=à ë † þý@ дI G $€¾Ñ ÷\À„þÎ ë ÷ à ü\…þþö à ë † þý · Œ¿ À„ $« Æ‘ / Ÿ’ . þ - Ì d À„ ‹ ¦8 9¾‡ W· uÀ„ ŠÊ n
|
|||
|
|
¥ j þ ¸¾‡ „¦8 £ À„
|
|||
|
|
þ ¸Ì Ð¥ â þ ’ f áN² Ž ¹* U ¶ƒ †<n n n µ Ä ¢ Õ e n ¶ƒ d Š Q X V S Ð
|
|||
|
|
Ç Å Ä
|
|||
|
|
¾‡ ½ ¼
|
|||
|
|
|
|||
|
|
|
|||
|
|
Î Ö¿ À„þ Û ¸ þ Ð Ð Ö¿š þ õ •¢Ì… Y ` { [ Ì ƒ
|
|||
|
|
Š X
|
|||
|
|
f
|
|||
|
|
¥ f ’ þ ª
|
|||
|
|
Ö¿À„þ ø ÿ
|
|||
|
|
À # Þ ' Æ - b W ^ e T 8 Ûs�R Ñ ÷\…þ‰ ë ÷ Ã ü\À„þþ² à ë
|
|||
|
|
† þý ´ Ð( ¼ º $€1 Ÿ’ Äè þ $Ç •¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜Ì… e · « Ì ‚ À„ È Ê n¥ ¨ þ ¸Ì Ð¥ â þ ’ f ¾‡ á ¦8 áNÅ Ž ë ¹ß … ¶ƒB †<n ¬å
|
|||
|
|
( ü . ü¼ @ Ò� ”Ì „¼O ¬†
|
|||
|
|
) � / üÝ @ Û£ ”í à¼O „¡ u v # þ . ˜ 5 < ,-./í _4½ �\Õ ÑÛ Ë
|
|||
|
|
,Ë u +ü9ä ü9, ) [`Error::UNEXPECTED`]: Error::UNEXPECTEDÁ üf [`fill_uninit`]: fill_uninitÁ ø ý“ü®& ý“# getrandom: system's random number generator
|
|||
|
|
|
|||
|
|
[![Build Status]][GitHub Actions]
|
|||
|
|
[![Crate]][crates.io]
|
|||
|
|
[![Documentation]][docs.rs]
|
|||
|
|
[![Dependency Status]][deps.rs]
|
|||
|
|
[![Downloads]][crates.io]
|
|||
|
|
[![License]][LICENSE-MIT]
|
|||
|
|
|
|||
|
|
`getrandom` is a Rust library for retrieving random data from (operating) system sources.
|
|||
|
|
|
|||
|
|
It is assumed that the system always provides high-quality, cryptographically secure random
|
|||
|
|
data, ideally backed by hardware entropy sources. This crate derives its name from
|
|||
|
|
the Linux `getrandom` syscall but is cross-platform, roughly supporting the same set
|
|||
|
|
of platforms as Rust's `std` library.
|
|||
|
|
|
|||
|
|
This is a low-level API. Most users should prefer using a higher-level random-number
|
|||
|
|
library like [`rand`].
|
|||
|
|
|
|||
|
|
[`rand`]: https://crates.io/crates/rand
|
|||
|
|
|
|||
|
|
## Usage
|
|||
|
|
|
|||
|
|
Add the `getrandom` dependency to your `Cargo.toml` file:
|
|||
|
|
|
|||
|
|
```toml
|
|||
|
|
[dependencies]
|
|||
|
|
getrandom = "0.3"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Then invoke the `fill` function on a byte buffer to fill it with random data:
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
fn get_random_u128() -> Result<u128, getrandom::Error> {
|
|||
|
|
let mut buf = [0u8; 16];
|
|||
|
|
getrandom::fill(&mut buf)?;
|
|||
|
|
Ok(u128::from_ne_bytes(buf))
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Supported targets
|
|||
|
|
|
|||
|
|
| Target | Target Triple | Implementation
|
|||
|
|
| ------------------ | ------------------ | --------------
|
|||
|
|
| Linux, Android | `*‑linux‑*` | [`getrandom`][1] system call if available, otherwise [`/dev/urandom`][2] after successfully polling `/dev/random`
|
|||
|
|
| Windows 10+ | `*‑windows‑*` | [`ProcessPrng`] on Rust 1.78+, [`RtlGenRandom`] otherwise
|
|||
|
|
| Windows 7, 8 | `*-win7‑windows‑*` | [`RtlGenRandom`]
|
|||
|
|
| macOS | `*‑apple‑darwin` | [`getentropy`][3]
|
|||
|
|
| iOS, tvOS, watchOS | `*‑apple‑{ios,tvos,watchos}` | [`CCRandomGenerateBytes`]
|
|||
|
|
| FreeBSD | `*‑freebsd` | [`getrandom`][5]
|
|||
|
|
| OpenBSD | `*‑openbsd` | [`getentropy`][7]
|
|||
|
|
| NetBSD | `*‑netbsd` | [`getrandom`][16] if available, otherwise [`kern.arandom`][8]
|
|||
|
|
| Dragonfly BSD | `*‑dragonfly` | [`getrandom`][9]
|
|||
|
|
| Solaris | `*‑solaris` | [`getrandom`][11] with `GRND_RANDOM`
|
|||
|
|
| illumos | `*‑illumos` | [`getrandom`][12]
|
|||
|
|
| Fuchsia OS | `*‑fuchsia` | [`cprng_draw`]
|
|||
|
|
| Redox | `*‑redox` | `/dev/urandom`
|
|||
|
|
| Haiku | `*‑haiku` | `/dev/urandom` (identical to `/dev/random`)
|
|||
|
|
| Hermit | `*-hermit` | [`sys_read_entropy`]
|
|||
|
|
| Hurd | `*-hurd-*` | [`getrandom`][17]
|
|||
|
|
| SGX | `x86_64‑*‑sgx` | [`RDRAND`]
|
|||
|
|
| VxWorks | `*‑wrs‑vxworks‑*` | `randABytes` after checking entropy pool initialization with `randSecure`
|
|||
|
|
| Emscripten | `*‑emscripten` | [`getentropy`][13]
|
|||
|
|
| WASI 0.1 | `wasm32‑wasip1` | [`random_get`]
|
|||
|
|
| WASI 0.2 | `wasm32‑wasip2` | [`get-random-u64`]
|
|||
|
|
| SOLID | `*-kmc-solid_*` | `SOLID_RNG_SampleRandomBytes`
|
|||
|
|
| Nintendo 3DS | `*-nintendo-3ds` | [`getrandom`][18]
|
|||
|
|
| ESP-IDF | `*‑espidf` | [`esp_fill_random`] WARNING: see "Early Boot" section below
|
|||
|
|
| PS Vita | `*-vita-*` | [`getentropy`][19]
|
|||
|
|
| QNX Neutrino | `*‑nto-qnx*` | [`/dev/urandom`][14] (identical to `/dev/random`)
|
|||
|
|
| AIX | `*-ibm-aix` | [`/dev/urandom`][15]
|
|||
|
|
| Cygwin | `*-cygwin` | [`getrandom`][20] (based on [`RtlGenRandom`])
|
|||
|
|
|
|||
|
|
Pull Requests that add support for new targets to `getrandom` are always welcome.
|
|||
|
|
|
|||
|
|
### Opt-in backends
|
|||
|
|
|
|||
|
|
`getrandom` also provides optional (opt-in) backends, which allow users to customize the source
|
|||
|
|
of randomness based on their specific needs:
|
|||
|
|
|
|||
|
|
| Backend name | Target | Target Triple | Implementation
|
|||
|
|
| ----------------- | -------------------- | ------------------------ | --------------
|
|||
|
|
| `linux_getrandom` | Linux, Android | `*‑linux‑*` | [`getrandom`][1] system call (without `/dev/urandom` fallback). Bumps minimum supported Linux kernel version to 3.17 and Android API level to 23 (Marshmallow).
|
|||
|
|
| `linux_raw` | Linux, Android | `*‑linux‑*` | Same as `linux_getrandom`, but uses raw `asm!`-based syscalls instead of `libc`.
|
|||
|
|
| `rdrand` | x86, x86-64 | `x86_64-*`, `i686-*` | [`RDRAND`] instruction
|
|||
|
|
| `rndr` | AArch64 | `aarch64-*` | [`RNDR`] register
|
|||
|
|
| `wasm_js` | Web Browser, Node.js | `wasm32‑unknown‑unknown`, `wasm32v1-none` | [`Crypto.getRandomValues`]. Enabled by the `wasm_js` feature ([see below](#webassembly-support)).
|
|||
|
|
| `efi_rng` | UEFI | `*-unknown‑uefi` | [`EFI_RNG_PROTOCOL`] with `EFI_RNG_ALGORITHM_RAW` (requires `std` and Nightly compiler)
|
|||
|
|
| `windows_legacy` | Windows | `*-windows-*` | [`RtlGenRandom`]
|
|||
|
|
| `custom` | All targets | `*` | User-provided custom implementation (see [custom backend])
|
|||
|
|
| `unsupported` | All targets | `*` | Always returns `Err(Error::UNSUPPORTED)` (see [unsupported backend])
|
|||
|
|
|
|||
|
|
Opt-in backends can be enabled using the `getrandom_backend` configuration flag.
|
|||
|
|
The flag can be set either by specifying the `rustflags` field in [`.cargo/config.toml`]:
|
|||
|
|
```toml
|
|||
|
|
# It's recommended to set the flag on a per-target basis:
|
|||
|
|
[target.wasm32-unknown-unknown]
|
|||
|
|
rustflags = ['--cfg', 'getrandom_backend="wasm_js"']
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Or by using the `RUSTFLAGS` environment variable:
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
RUSTFLAGS='--cfg getrandom_backend="linux_getrandom"' cargo build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Enabling an opt-in backend will replace the backend used by default. Doing this for
|
|||
|
|
an incorrect target (e.g. using `linux_getrandom` while compiling for a Windows target)
|
|||
|
|
will result in a compilation error. Be extremely careful while using opt-in backends,
|
|||
|
|
as incorrect configuration may result in vulnerable applications or applications
|
|||
|
|
that always panic.
|
|||
|
|
|
|||
|
|
Note that using an opt-in backend in a library (e.g. for tests or benchmarks)
|
|||
|
|
WILL NOT have any effect on its downstream users.
|
|||
|
|
|
|||
|
|
[`.cargo/config.toml`]: https://doc.rust-lang.org/cargo/reference/config.html
|
|||
|
|
|
|||
|
|
### Raw Linux syscall support
|
|||
|
|
|
|||
|
|
Currently the `linux_raw` backend supports only targets with stabilized `asm!` macro,
|
|||
|
|
i.e. `arm`, `aarch64`, `loongarch64`, `riscv32`, `riscv64`, `s390x`, `x86`, and `x86_64`.
|
|||
|
|
|
|||
|
|
Note that the raw syscall backend may be slower than backends based on `libc::getrandom`,
|
|||
|
|
e.g. it does not implement vDSO optimizations and on `x86` it uses the infamously slow
|
|||
|
|
`int 0x80` instruction to perform syscall.
|
|||
|
|
|
|||
|
|
### WebAssembly support
|
|||
|
|
|
|||
|
|
This crate fully supports the [WASI] and [Emscripten] targets. However,
|
|||
|
|
the `wasm32-unknown-unknown` target (i.e. the target used by `wasm-pack`)
|
|||
|
|
is not automatically supported since, from the target name alone, we cannot deduce
|
|||
|
|
which JavaScript interface should be used (or if JavaScript is available at all).
|
|||
|
|
|
|||
|
|
We do not include support for this target in the default configuration because
|
|||
|
|
our JS backend (supporting web browsers, web workers and Node.js v19 or later)
|
|||
|
|
requires [`wasm-bindgen`], **bloating `Cargo.lock`** and
|
|||
|
|
**potentially breaking builds** on non-web WASM platforms.
|
|||
|
|
|
|||
|
|
To enable `getrandom`'s functionality on `wasm32-unknown-unknown` using the Web
|
|||
|
|
Crypto methods [described above][opt-in] via [`wasm-bindgen`], enable the
|
|||
|
|
`wasm_js` feature flag. Setting `RUSTFLAGS='--cfg getrandom_backend="wasm_js"'`
|
|||
|
|
is allowed but is no longer required and does nothing (it was required in a
|
|||
|
|
prior version of this crate).
|
|||
|
|
|
|||
|
|
WARNING: enabling the `wasm_js` feature will bloat `Cargo.lock` on all platforms
|
|||
|
|
(where [`wasm-bindgen`] is not an existing dependency) and is known to cause
|
|||
|
|
build issues on some non-web WASM platforms, even when a different backend is
|
|||
|
|
selected via `getrandom_backend`.
|
|||
|
|
|
|||
|
|
### Custom backend
|
|||
|
|
|
|||
|
|
If this crate does not support your target out of the box or you have to use
|
|||
|
|
a non-default entropy source, then you can provide a custom implementation.
|
|||
|
|
You need to enable the custom backend as described in the
|
|||
|
|
[opt-in backends][opt-in] section.
|
|||
|
|
|
|||
|
|
Next, you need to define an `extern` function with the following signature:
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
use getrandom::Error;
|
|||
|
|
|
|||
|
|
#[no_mangle]
|
|||
|
|
unsafe extern "Rust" fn __getrandom_v03_custom(
|
|||
|
|
dest: *mut u8,
|
|||
|
|
len: usize,
|
|||
|
|
) -> Result<(), Error> {
|
|||
|
|
todo!()
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
This function should, ideally, be defined in the root crate of your project,
|
|||
|
|
e.g. in your `main.rs`. This function MUST be defined only once for your
|
|||
|
|
project, i.e. upstream library crates SHOULD NOT define it outside of
|
|||
|
|
tests and benchmarks. Improper configuration of this backend may result
|
|||
|
|
in linking errors.
|
|||
|
|
|
|||
|
|
The function accepts a pointer to a buffer that should be filled with random
|
|||
|
|
data and its length in bytes. Note that the buffer MAY be uninitialized.
|
|||
|
|
On success, the function should return `Ok(())` and fully fill the input buffer;
|
|||
|
|
otherwise, it should return an error value.
|
|||
|
|
|
|||
|
|
While wrapping functions which work with byte slices you should fully initialize
|
|||
|
|
the buffer before passing it to the function:
|
|||
|
|
```rust
|
|||
|
|
use getrandom::Error;
|
|||
|
|
|
|||
|
|
fn my_entropy_source(buf: &mut [u8]) -> Result<(), getrandom::Error> {
|
|||
|
|
// ...
|
|||
|
|
Ok(())
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
#[no_mangle]
|
|||
|
|
unsafe extern "Rust" fn __getrandom_v03_custom(
|
|||
|
|
dest: *mut u8,
|
|||
|
|
len: usize,
|
|||
|
|
) -> Result<(), Error> {
|
|||
|
|
let buf = unsafe {
|
|||
|
|
// fill the buffer with zeros
|
|||
|
|
core::ptr::write_bytes(dest, 0, len);
|
|||
|
|
// create mutable byte slice
|
|||
|
|
core::slice::from_raw_parts_mut(dest, len)
|
|||
|
|
};
|
|||
|
|
my_entropy_source(buf)
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Unsupported backend
|
|||
|
|
|
|||
|
|
In some rare scenarios, you might be compiling this crate for an unsupported
|
|||
|
|
target (e.g. `wasm32-unknown-unknown`), but this crate's functionality
|
|||
|
|
is not actually used by your code. If you are confident that `getrandom` is
|
|||
|
|
not used in your project, but it gets pulled nevertheless by one of your
|
|||
|
|
dependencies, then you can enable the `unsupported` backend, which always
|
|||
|
|
returns `Err(Error::UNSUPPORTED)`.
|
|||
|
|
|
|||
|
|
### Platform Support
|
|||
|
|
|
|||
|
|
This crate generally supports the same operating system and platform versions
|
|||
|
|
that the Rust standard library does. Additional targets may be supported using
|
|||
|
|
the opt-in custom backend.
|
|||
|
|
|
|||
|
|
This means that as Rust drops support for old versions of operating systems
|
|||
|
|
(such as old Linux kernel versions, Android API levels, etc.) in stable releases,
|
|||
|
|
`getrandom` may create new patch releases that remove support for
|
|||
|
|
outdated platform versions.
|
|||
|
|
|
|||
|
|
### `/dev/urandom` fallback on Linux and Android
|
|||
|
|
|
|||
|
|
On Linux targets, the `/dev/urandom` fallback is present only if either `target_env`
|
|||
|
|
is `musl`, or `target_arch` is one of the following: `aarch64`, `arm`, `powerpc`,
|
|||
|
|
`powerpc64`, `s390x`, `x86`, `x86_64`. Other supported targets [require][platform-support]
|
|||
|
|
kernel versions that support the `getrandom` system call, so the fallback is not needed.
|
|||
|
|
|
|||
|
|
On Android targets the fallback is present only for the following `target_arch`es:
|
|||
|
|
`aarch64`, `arm`, `x86`, `x86_64`. Other `target_arch`es (e.g. RISC-V) require
|
|||
|
|
sufficiently high API levels.
|
|||
|
|
|
|||
|
|
The fallback can be disabled by enabling the `linux_getrandom` opt-in backend.
|
|||
|
|
Note that doing so will bump minimum supported Linux kernel version to 3.17
|
|||
|
|
and Android API level to 23 (Marshmallow).
|
|||
|
|
|
|||
|
|
### Early boot
|
|||
|
|
|
|||
|
|
Sometimes, early in the boot process, the OS has not collected enough
|
|||
|
|
entropy to securely seed its RNG. This is especially common on virtual
|
|||
|
|
machines, where standard "random" events are hard to come by.
|
|||
|
|
|
|||
|
|
Some operating system interfaces always block until the RNG is securely
|
|||
|
|
seeded. This can take anywhere from a few seconds to more than a minute.
|
|||
|
|
A few (Linux, NetBSD and Solaris) offer a choice between blocking and
|
|||
|
|
getting an error; in these cases, we always choose to block.
|
|||
|
|
|
|||
|
|
On Linux (when the `getrandom` system call is not available), reading from
|
|||
|
|
`/dev/urandom` never blocks, even when the OS hasn't collected enough
|
|||
|
|
entropy yet. To avoid returning low-entropy bytes, we first poll
|
|||
|
|
`/dev/random` and only switch to `/dev/urandom` once this has succeeded.
|
|||
|
|
|
|||
|
|
On OpenBSD, this kind of entropy accounting isn't available, and on
|
|||
|
|
NetBSD, blocking on it is discouraged. On these platforms, nonblocking
|
|||
|
|
interfaces are used, even when reliable entropy may not be available.
|
|||
|
|
On the platforms where it is used, the reliability of entropy accounting
|
|||
|
|
itself isn't free from controversy. This library provides randomness
|
|||
|
|
sourced according to the platform's best practices, but each platform has
|
|||
|
|
its own limits on the grade of randomness it can promise in environments
|
|||
|
|
with few sources of entropy.
|
|||
|
|
|
|||
|
|
On ESP-IDF, if `esp_fill_random` is used before enabling WiFi, BT, or the
|
|||
|
|
voltage noise entropy source (SAR ADC), the Hardware RNG will only be seeded
|
|||
|
|
via RC_FAST_CLK. This can occur during early boot unless
|
|||
|
|
`bootloader_random_enable()` is called. For more information see the
|
|||
|
|
[ESP-IDF RNG Docs][esp-idf-rng] or the
|
|||
|
|
[RNG section of the ESP32 Technical Reference Manual][esp-trng-docs].
|
|||
|
|
|
|||
|
|
## Error handling
|
|||
|
|
|
|||
|
|
We always prioritize failure over returning known insecure "random" bytes.
|
|||
|
|
Generally, on supported platforms, failure is highly unlikely, though not
|
|||
|
|
impossible. If an error does occur, it is likely that it will occur
|
|||
|
|
on every call to `getrandom`. Therefore, after the first successful call,
|
|||
|
|
one can be reasonably confident that no errors will occur.
|
|||
|
|
|
|||
|
|
## Panic handling
|
|||
|
|
|
|||
|
|
We strive to eliminate all potential panics from our backend implementations.
|
|||
|
|
In other words, when compiled with optimizations enabled, the generated
|
|||
|
|
binary code for `getrandom` functions should not contain any panic branches.
|
|||
|
|
Even if the platform misbehaves and returns an unexpected result,
|
|||
|
|
our code should correctly handle it and return an error, e.g.
|
|||
|
|
[`Error::UNEXPECTED`].
|
|||
|
|
|
|||
|
|
## Sanitizer support
|
|||
|
|
|
|||
|
|
If your code uses [`fill_uninit`] and you enable
|
|||
|
|
[MemorySanitizer](https://doc.rust-lang.org/beta/unstable-book/compiler-flags/sanitizer.html#memorysanitizer)
|
|||
|
|
(i.e. `-Zsanitizer=memory`), we will automatically handle unpoisoning
|
|||
|
|
of the destination buffer filled by `fill_uninit`.
|
|||
|
|
|
|||
|
|
You can run sanitizer tests for your crate dependent on `getrandom` like this:
|
|||
|
|
```sh
|
|||
|
|
RUSTFLAGS="-Zsanitizer=memory" cargo test -Zbuild-std --target=x86_64-unknown-linux-gnu
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Minimum Supported Rust Version
|
|||
|
|
|
|||
|
|
This crate requires Rust 1.63 or later.
|
|||
|
|
|
|||
|
|
## License
|
|||
|
|
|
|||
|
|
The `getrandom` library is distributed under either of
|
|||
|
|
|
|||
|
|
* [Apache License, Version 2.0][LICENSE-APACHE]
|
|||
|
|
* [MIT license][LICENSE-MIT]
|
|||
|
|
|
|||
|
|
at your option.
|