775 lines
100 KiB
Plaintext
775 lines
100 KiB
Plaintext
|
!<arch>
|
|||
|
|
/ 0 0 0 0 616 `
|
|||
|
|
eÈ eÈ eÈ eÈ eÈ eÈ eÈ_ZN60_$LT$getrandom..error..Error$u20$as$u20$core..fmt..Debug$GT$3fmt17h283c0839f7622f6eE _ZN62_$LT$getrandom..error..Error$u20$as$u20$core..fmt..Display$GT$3fmt17hdc3f365963a81d9bE _ZN9getrandom5error5Error10from_errno17hbebb77818411a275E _ZN9getrandom8backends27linux_android_with_fallback17use_file_fallback17hae665d34489a5e98E _ZN9getrandom8backends27linux_android_with_fallback4init17h4d73ca3abf1a874eE _ZN9getrandom8backends8use_file5utils9get_errno9get_errno17h8f51c5adcbf55d7cE _ZN9getrandom8backends27linux_android_with_fallback10fill_inner12GETRANDOM_FN17h8b4c89e8f50b2e38E // 68 `
|
|||
|
|
getrandom-b4a33f586d36bdb6.getrandom.496b6f6f21826823-cgu.0.rcgu.o/
|
|||
|
|
lib.rmeta/ 0 0 0 644 90720 `
|
|||
|
|
ELF · à` @ @ GNU À rust
|
|||
|
|
V^ #rustc 1.96.0 (ac68faa20 2026-05-25)ÁíàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ cfg_ifÁŸ=�ê @Êq{0¡¡£ª -c28393f1568b0153Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ–� `ãŒN€ZÛ:õ\ -7ce82f3507212cabÁ ‰À % »À| error_std_implsÁ|ˆ»À|ò sys_rngÁ<Ò»›œ¸ rand_coreÁL€»›œâ SysRngÁ4¸»›œ‘ implementationÁt‰
|
|||
|
|
getrandom_backendÁ extern_implÁüÝ !0 inner_u32ÁL„ú androidÁ¬¿ú linuxÁœÖü¾,üº10 inner_u64ÁL�úÌ=úß64130ç$Æ ú̬“ úßœª ü’ ,üŽ 1 í _ backendsÁ errorÁ UNSUPPORTEDÁ ERRNO_NOT_POSITIVEÁ
|
|||
|
|
UNEXPECTEDÁ INTERNAL_STARTÁ CUSTOM_STARTÁ
|
|||
|
|
from_errnoÁ 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Á $¥ ´ ø truncateÁ fillÁ fill_uninitÁ Ô Ú use_fileÁ 0 000000000 utilsÁ : :: get_errnoÁ =¾ : sanitizerÁ ? ? unpoisonÁ :: sys_fill_exactÁ C 0impl Fn(&mut [MaybeUninit<u8>]) -> libc::ssize_tÁ C 0 FILE_PATHÁ 0 FD_UNINITÁ 0 FD_ONGOING_INITÁ 0 FDÁ 0
|
|||
|
|
fill_innerÁ J 0
|
|||
|
|
open_readonlyÁ 0 open_or_waitÁ 0 open_fdÁ 0ç O OOOOOO waitÁ O wakeÁ O wait_until_rng_readyÁ linux_android_with_fallbackÁ Y YYYYYYYYY Y
|
|||
|
|
Y Y Y
|
|||
|
|
Y GetRandomFnÁ Y
|
|||
|
|
NOT_AVAILABLEÁ Y initÁ Y use_file_fallbackÁ Y‹ l lazyÁ m mmmmmmmm LazyPtrÁ v
|
|||
|
|
v¥ vˆ m z¥ zæ z cold_initÁ }– } &impl FnOnce() -> Result<NonNull<T>, E>Á z try_unsync_initÁ €– €Ã z unsync_initÁ ƒ impl FnOnce() -> NonNull<T>Á ƒ l GETRANDOM_FNÁ l =
|
|||
|
|
RawOsErrorÁ NonZeroRawOsErrorÁ ErrorÁ Œ
|
|||
|
|
Œˆ ‘ƒ “Ö –�
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
!
|
|||
|
|
"
|
|||
|
|
$
|
|||
|
|
,
|
|||
|
|
-
|
|||
|
|
A
|
|||
|
|
C
|
|||
|
|
C
|
|||
|
|
J
|
|||
|
|
L
|
|||
|
|
k
|
|||
|
|
l
|
|||
|
|
}
|
|||
|
|
€
|
|||
|
|
ƒ
|
|||
|
|
’
|
|||
|
|
”
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
Š Œ Œ �˜ Žˆ `- 8ê©JT ÛÔ ØÔ ™Ô ÐìÔ µßÔÔ ¾ Ô ¿cÔ ÄcÔ � Œ� Œ‘ Œ“ Œ• Œ– Œ Œ Œ ŒŠ <ÛØ™Ðìµß¾ ¿cÄc í A üÐ� ôÏ ƒ
|
|||
|
|
ÑÛÑÛ MaybeUninitÁ ÓÛ uninitÁÝ ÔÛ»Ý Íõƒ«%9 ç bufÁ Œ üÙ‡ à Uÿ!, tà í 4å
|
|||
|
|
Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
îÔ ì
|
|||
|
|
— ‡ Dƒ lƒ Œ * ¾
|
|||
|
|
’" ‘
|
|||
|
|
÷ \ M V � <¹ - ´¹
|
|||
|
|
B à ì²
|
|||
|
|
\öe
|
|||
|
|
> ¿ øtà4
|
|||
|
|
üà3 ¤à 1‰Ád µ û , ] Lš ÿÿÿÿÿÿÿÿÿ ¤Ú
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
,¢ ( ìŒ
|
|||
|
|
Ö¿îÔ ¨
|
|||
|
|
^ É
|
|||
|
|
Ò } ' í
|
|||
|
|
A ü¹´ I‰ád i‰Þd Ö¿ ¨ €“€“ �“ TryFromIntErrorÁ ‚“ˆ Z} Ràvq ‰êd ‰Âe ôõ
|
|||
|
|
’� « ¨ -˜� Ö¿ ¨ Ô @ ’
|
|||
|
|
ù¶ « ¨ Åÿ¶
|
|||
|
|
•¢ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ˆê )?ÈXM´ Ô¨ Â É t“ üà4
|
|||
|
|
l ¨ ”
|
|||
|
|
øv³7 ü³6 ì³ �žø, U¥ø, + Ž Š Uµ� Ö¿¨ Ô ù Ô ¼ } “ š
|
|||
|
|
©· Ô 5·
|
|||
|
|
Ö¿ø Ô Õ¯·
|
|||
|
|
•¢ª ¨
|
|||
|
|
È· E u“
|
|||
|
|
|
|||
|
|
[ ª 3' :) EÔº+ '
|
|||
|
|
uκ+ ) ' â û #+ )
|
|||
|
|
ïº+ (
|
|||
|
|
Ô •õº, Ö¿îÔ ( ²) ¹' Ð
|
|||
|
|
L ,ýÓù+, Ýáù,
|
|||
|
|
! $ %ôÈ, $ ÕôÈ, $ ú ýÿ=(b % ýÃ')^" % ù ýù=.b %
|
|||
|
|
¦>b % eúá," ý¾º O# " ½ˆâ,#
|
|||
|
|
# s$& o* & ù " # k$ ! & g$&
|
|||
|
|
Ÿâ,#
|
|||
|
|
" ý§áˆ, ! $
|
|||
|
|
! ýÎù1, Û¼÷÷
|
|||
|
|
þù,
|
|||
|
|
ªú, ÄÑ*
|
|||
|
|
²†1. * Û ë% -¸†1/ Ö¿ ë%Ô * @* è ‰+ �, j0 + « ë% g1 •¢ ª ë% + É, Ð+ vé ü³7 1 l ë% ÷ l ë%÷ ê Ä
|
|||
|
|
õ ñ* EÓ†1. Ö¿ë%Ô É Ô "* ã j+ q, Ï0 , Ô Ì2- Ó2 - Ö¿ø Ô , Ê2 •¢ª ë% - Ç2- Ó, Ú+
|
|||
|
|
wé [ ª ÿ
|
|||
|
|
.
|
|||
|
|
0 Ä5 . Á5 0 . û á5 0 ¿5 / Ô ¼6 Ö¿îÔ / s
|
|||
|
|
0 z
|
|||
|
|
. n
|
|||
|
|
C 8b üùç ü²“ üÖï ™ § ñ ü¦Ÿ û üêà ýÐ!D, ÛsúTä ù‰÷cÚ ‘æ ýð‹à ç[¨ Â Ô EŸ Â Ô î— u�� ¥«� ¬ý EŸ§,ª,î-¹�ý–¶Ä ÷\¨ Ô¯ ýö¶! ý¥·$ ý¸÷ù, »túÌ· ýÀÜÿ, ¹túý¤Ý›, ýÂÝý, ý½ÈW, …túeÑÝ,ýí7Âb îr úå¹á,ý¬*ñF š 9úî$F ù‘¬Þ[ ÿÝ ù‘“á4 ýÞjKX Àúuè;b ý»•MX Êú}—<b ýïÁtN Æú§ ýµ&¹^! ºùúíÄÂN!ýí¯ø
|
|||
|
|
O éúEþá,Ñ îr úýçá9,Í$ š È$Ã% ÿÝ ¼%µ$ Àú±$®$ Êú©$¦$ ÆúH$¡) ºùúœ)ý�º— ü\îÔÔ– åëº+ +ýáè$W, † Ômùº+ýÄ…¨1 ÆTë%Ô¢ …†1. .K ÷\ë%Ôý F0 0B0 0Ú A ´… ã 3 3£
|
|||
|
|
ü\îÔÔ; �5 5™6 † Ô”5 2à ŒÁ ÷ <Û Ÿ D€ ù ‚
|
|||
|
|
û ý Ÿ Q ¥ e ÷ m û ² Ó •¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜ª ¨ Y Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¨ Ô c Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¨ Â l ª ¨ ë
|
|||
|
|
•¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜ª ë% $ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ë%Ô s ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙë% · ª ê §, ,îÔ á ¨ —
|
|||
|
|
t ¨ ’
|
|||
|
|
¨ )
|
|||
|
|
¨ Ý Ô i ª Y ¨ ë% X
|
|||
|
|
ð# ÆÝ,÷ ù÷ 5ð# ô ¨ Þ ù …ôÈ,²8 M
|
|||
|
|
²8 U
|
|||
|
|
$û 5ëº+ Ô + < + ë% X . ë% v
|
|||
|
|
0 Ô 0ª ò 0û :5 Ô ? 5 r 5 ÷ ñ ×v sys_fillÁƒ resÁ€ Ï8e Ï8q ‘ Ú Ž
|
|||
|
|
¹_
|
|||
|
|
· « 1 ½ ® Ž ~ ¹’ ë% ÷ 1 ¹¥ ë%÷ errnoÁÃ
|
|||
|
|
ˆ
|
|||
|
|
Œ× Ô\ã Û/ §,Œ½
|
|||
|
|
ÔŒ� Ôý‡k X �ú ¨ ýå•!X ‚ú ¨ ' �ú ¨ # ‚ú ¨ Ÿ6 ™e Á4 öá Ÿ6 Ÿ6
|
|||
|
|
Úsú—
|
|||
|
|
Ÿ,
|
|||
|
|
Ï� ™<: ™<U®Ý,
|
|||
|
|
±Ï éùˆ%F
|
|||
|
|
ŽÏ éúˆ%F Ë<
|
|||
|
|
Ô
|
|||
|
|
ë†1 Î Ö
|
|||
|
|
Ô ’ E D Ô € Ÿ, Y Â þ j! Ô
|
|||
|
|
ø«ø« ] ù« innerÁ°3 HeÏ c"/dev/urandom"Á ÿÿÿÿ§, -1Á þÿÿÿ§, -2Á̧ T§ —Õ ¨ Ë4Ì4Í4
|
|||
|
|
__variant1Á Î4Ï4
|
|||
|
|
__variant2Á �ë ò g ü�1
|
|||
|
|
|
|||
|
|
´�
|
|||
|
|
žé> ‘ + À üàd i ‰‰ § ‹‰ ï íe¼îËè¿*é> |õ è> ù Yó —Õ ¨ _Á Œ¾ ü‡# Ö
|
|||
|
|
|
|||
|
|
€é>ø …é>
|
|||
|
|
j §, îÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ˆ@ø ¢AÖ
|
|||
|
|
v v wú
|
|||
|
|
yˆ m 7l@@bÆ�±é> $‡Ö
|
|||
|
|
™Alœ ôŒ ¼ùÖ
|
|||
|
|
|
|||
|
|
k $‹ d� ü¨4 è>¨ û ü„X ‡ ùû ¢C ˆ üèuÖ
|
|||
|
|
|
|||
|
|
C ‡ÚCÝCóC $þ ƒ 4 Ü â üÖ� å
|
|||
|
|
,è Ö
|
|||
|
|
û + ë « ˆ@ ª X _ ¬Ù ýÕ€$%
|
|||
|
|
è> ý®¤ %
|
|||
|
|
Ö
|
|||
|
|
ÿÿÿÿÿÿÿÿè> A l üà… ü¦¿ üŒ× ü�¬ ƒé>¢Aí üäW ý�¤R% ûé>§ ý†~û% ªé>E³¤% ªé>EŤ%/ ªé>DÓ à Œ“ ÷ $ò ˆ@ $ª ¢C VœD 8 õC @ ¯A ƒû ” ›è> m®¤% destÁZ fptrÁb getrandom_fnÁ¿ /lá i ˆ@ öB —Dg �Aÿ ) 1 i ˆ@ < J l ƒ ˆ@ g ˆ@ n uy i ˆ@ üã |ò
|
|||
|
|
lò
|
|||
|
|
² ¥ - :
|
|||
|
|
A tã
|
|||
|
|
Ò]ŽJ Q b � üÞ% v ŽJ ‚ ‰ | ü¹P v v wú
|
|||
|
|
yˆ m 7l@@bÆ�±ŽJ $Ï ¤]¤] V ¦]Á‚] üß3ø¤”& ŽJ óK ƒ 8€ì 4ì
|
|||
|
|
Ö
|
|||
|
|
|
|||
|
|
™"Ãî $ìÖ
|
|||
|
|
î4 < J P V
|
|||
|
|
%㶠Uݶ Ö
|
|||
|
|
· ú
|
|||
|
|
– Ö¿ø ºM
|
|||
|
|
7 •¢Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ø ºM‰‰ § ‹‰ ï íe¼îËè¿*ŽJ V p
|
|||
|
|
w ~ €ò �ò [ óM § ® š
|
|||
|
|
¨
|
|||
|
|
Ö
|
|||
|
|
û ¨
|
|||
|
|
Ô
|
|||
|
|
|
|||
|
|
ºM ì Ö¿ÇNºM
|
|||
|
|
" ó ¶ ~ « ÇN — •¢ óMÇN n
|
|||
|
|
u | þ <ì l ÇN v dŠ ë óK m•¹
|
|||
|
|
Eš¹
|
|||
|
|
%©¯“ ÆK î0î0
|
|||
|
|
UnsafeCellÁ ð0»Ì- ·}—KEüC£™]™] š] Align8Á œ]ˆ‹] ̲ˆ364¥óK M‡O óK §
|
|||
|
|
ýˆ¹'
|
|||
|
|
Ö
|
|||
|
|
|
|||
|
|
ù]óK Õ ¤¹Ö
|
|||
|
|
¼À½À¾ÀË ¿ÀÀÀÌ ÁÀÂÀG ÃÀÄÀF ÅÀÆÀ× `šÁ¬S øB -©¹ «
|
|||
|
|
®¹
|
|||
|
|
Ÿ <ª Ö¿ ÇNºM " } üú½ üâU ç î õ 5 ÷\ÇNºM£ 0 , S ªŽJDŽ ‰ ü\ÇNºMºMÞ „
|
|||
|
|
|
|||
|
|
� † ºM}
|
|||
|
|
ýõ·Ë Ý]ŽJä„ ýùM
|
|||
|
|
ï]ŽJa
|
|||
|
|
ý‚ß“ û0³R-þ¹ýØ>O ³RóK5„º Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÇNºM ¬Â �K ,Š ºL $‘ •¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜óMÇN ) üV ' óM ª ÇN ¸ óK ¤ û -ö¶ ÇN ~ ºM úóM û 7
|
|||
|
|
ºM Ô
|
|||
|
|
¨
|
|||
|
|
î
|
|||
|
|
ýR ×
|
|||
|
|
ûQ 婯“ ä ¥
|
|||
|
|
è ¹ æ Ž C ¹U ƒ ´Lç šS‚ � Ö
|
|||
|
|
lš m«± Z ÆK ûQ óK ýŸ±!Ö
|
|||
|
|
|
|||
|
|
þ]óK MÖ
|
|||
|
|
»S-º± 7 ’
|
|||
|
|
�
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
ü‚ ¢ ! 1
|
|||
|
|
¿± Ï |· Uõ Z ýã1!Z
|
|||
|
|
¨ mžT% $Ž
|
|||
|
|
Ö
|
|||
|
|
¤ÿ Ö
|
|||
|
|
|
|||
|
|
}ŽJºMºL $ÿ M |„
|
|||
|
|
s ý…U#%
|
|||
|
|
uœM%
|
|||
|
|
ÇN ý€U)% Û¼ÇN
|
|||
|
|
|
|||
|
|
¨U%
|
|||
|
|
Ú Û ÇN <â Ö¿ ÇNºM k j € k ü‹ ™ ¤Õ ýœ°¬ Ü]ŽJ1 8 ï]ŽJE°±7 û0³R1. ³RóK+ýâSù% ŸŽJ± ýšNO ÁŽJM¢T%ý´'CO ÈŽJeÌOý¶ìZ ÚŽJMÙOýå½Z
|
|||
|
|
|
|||
|
|
ùó¬Þ[ ½Ý ùó“á4
|
|||
|
|
ý¥.çZ âÉ5ù Z ý˜@Z
|
|||
|
|
ÛÉîe÷1Z
|
|||
|
|
ý”J¦% žŽJÅŽU%¤ š 9�î$F¼ ÿÝ Î üV ¬ë ÖW ,¥ ºL $´ óK ¤ ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÇN ÇN 1ºL Û m ßZ óY ~ÇN ˜¨ 6 ¥
|
|||
|
|
¤ »L ¹� ± ó\ ºLÖºLÜ öZ/
|
|||
|
|
¼Ý é�ˆ%F 8 _ f …ŽJ©§, îÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÇNø Îc Ç Ö
|
|||
|
|
|
|||
|
|
€ŽJø …ŽJÎc§,×c³d $ © ' Ö
|
|||
|
|
û G « ÇN » ƒ ¬ š ÇN TÏ ÖW ,¢ Îc $© Üc ¥ Öd Í û ¾ Å 3 ¥
|
|||
|
|
7 »µ Êdó 4¢ $¢ Îc ! Ö
|
|||
|
|
|
|||
|
|
™"Îcî 3Ö
|
|||
|
|
îF N § TŸ Ö¿ ÇNø ¨ © … ° Üc ž Öd Å ÇN ® Îc ¥
|
|||
|
|
" Îc ë ¢gÖ ¥
|
|||
|
|
dŸ õC ¼¬ Q $ è> LÅ üŸ3 H )Ö
|
|||
|
|
©C Ð . Ñ Ü ‡ ^ n …túd° Ì Âúé>4½ û ‰ œD Ÿ ÷ … ¢C è> ì ¨ Ï õC Æ ²8 I ×2 ½G õC õ ™< ¢Cÿ _ref__getrandom_fnÁ (DÄ
|
|||
|
|
DÉ
|
|||
|
|
’ " ' Ô 3 Ô = F P EÍ
|
|||
|
|
” EË
|
|||
|
|
î Žl $ . %¥8E ô ô õ ¨ ÷ ˆÐ mjç�ítoé§, ý×�%E §,
|
|||
|
|
®8E -³8E œm 5 §,
|
|||
|
|
½8E yçÔÞ" FØ
|
|||
|
|
— HFÏ
|
|||
|
|
ýø7LE …
|
|||
|
|
§,ˆFì
|
|||
|
|
ýéx› E ·
|
|||
|
|
§,-ª8E ·
|
|||
|
|
§,-¹8Eùç¯Þ6" šà Í¥8E j Žl q Žl x §, U¥8Eœm H §, ]³8Eœm ó ¤ ¹
|
|||
|
|
± » ¬ï
|
|||
|
|
ӕ
|
|||
|
|
‚
|
|||
|
|
0 üÐ5 Ô ,ç $ _Á ¬õ
|
|||
|
|
”õ ¤p ˆ µp
|
|||
|
|
. üÏ<
|
|||
|
|
Ô ,í $ _Á ¬ÿ
|
|||
|
|
”ÿ ¤p ’ µp
|
|||
|
|
. üá4 Ô ,÷ $ _Á <ø ý §,©C ) ©C 9 ø §,I §, e * §,q §, üÕ+ §, Të ©C ° ¶ 1 _Á <ç ì §,©C ) ©C 9 ç §,I §, e * §,q §, üÆ)
|
|||
|
|
§, TÚ ©C ° ¶ 1 _Á 4‘$ œm = §, œ$ Lå- Ö
|
|||
|
|
§, % $�. Ö
|
|||
|
|
ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ§, üâ-À l×.
|
|||
|
|
„’ €€€€ ¡/ ²/ 2 ü™.‰ ]�’Ö
|
|||
|
|
|
|||
|
|
ÌÙ "Ö
|
|||
|
|
•x 6 )žúˆ5 9žÛŸ5 Û¼§, ùž°Ÿ45 !žÍŸ5 Ö
|
|||
|
|
êv ) üÌ#æ ü†$¬ X ·
|
|||
|
|
§,,˜$ ùžÂž¬5 ôÉ # ùžÿžo5 ùžÄ‡Û5 ¯Ê ‰ž‘Ÿ5ýÔ‘x Æ ùžˆˆ'5 Æ ¹ž³Ÿ5 êv ”é# Ô $à# §, $Š$ œm i B §, / î q î y ; codeÁC ùIž¥ˆ5 ÆÉ §,IžÃˆ5 ÆÉ §, •xÉ •xÏ Œº1 §, ü¤1' Ö
|
|||
|
|
§, Ê1 üÛ11 üä1& eØfE ýïb"E ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙœm ` •ÒfE û !
|
|||
|
|
øfE Û œm
|
|||
|
|
ßjE ¾ üÕ18 Œ Œ2 “2 üŠ0‰ ü™1z ý˜fÎE ´
|
|||
|
|
§, eófE ýŒa�E ³
|
|||
|
|
§,/¤ š 9æî$F¼ ÿÝ Î Ô ,0 µp ¢0 §, $�1 §, È œm ” Ç| Šû =ófE 1 ¹> ”zB Ðœ¤1
|
|||
|
|
§,
|
|||
|
|
¡” éæˆ%F r 7 »1 Q §, , Q d
|
|||
|
|
§, K J $…2 [
|
|||
|
|
cüä1
|
|||
|
|
´
|
|||
|
|
§, 6 † ‰2 Ï Œ Í ’2 Ô Ó Ð Ô r µp q §, p §, 7 µp œm §,  ¹£ ”z¨ 7h
|
|||
|
|
§, Œª4 §, ü’4) Ö
|
|||
|
|
§, º4 üË41 üÔ4& ‰ ‡ Ç| Ÿ @ M û ` @ Û œm > q üÅ48 Œ ü4 ƒ5 üí2– ü‡4| < ´
|
|||
|
|
§,Ç 7 5 ³
|
|||
|
|
§,`¤ š 1¼ ÿÝ Î Ô ,™3 µp Ž3 §, $‹4 §, l œm 8 Ç| ·û - \ ¹< ”z@ ¿¬’4 §, ý' h Ñ «4 ë §, Æ ë \ §, å ä $õ4 õ
|
|||
|
|
ýüÔ4 ˜� 1 ù4 ± Œ ¯ ‚5 ¶ µ ² Ô c µp b §, a §, Ì µp ü œm Ÿ §, ¼ ¹“ ”z˜ Z §, ¤Ø
|
|||
|
|
Ì«N üØ
|
|||
|
|
ŽJ ÷ L× ä ü÷í üΖ ýŠ«EN Â
|
|||
|
|
ÑÛÑÛ † ÓÛ›Ý ÔÛ»Ý Íõƒ«%9ŽJ¹ ®‰ D¿ ÿ‰ ,ž ‰ Å ÿ‰ ç ž µ Ò ³ ¤Ù üÙ - èŠ …
|
|||
|
|
Lå
|
|||
|
|
ò
|
|||
|
|
$ üúø üÏ £ ®‰r ÓŠ ¬³ ÆŠ ,Ÿ èŠ { ‰ ˜ ž µ Ó i
|
|||
|
|
<ó Õëƒ? Ö
|
|||
|
|
ÑÛÑÛ † ÓÛ›Ý ÔÛ»Ý Íõƒ«%9©C %–Ë?
|
|||
|
|
c
|
|||
|
|
|
|||
|
|
ð# ù
|
|||
|
|
Ö
|
|||
|
|
¨ – Àkú
|
|||
|
|
¼ú
|
|||
|
|
|
|||
|
|
Ô²
|
|||
|
|
Ö
|
|||
|
|
|
|||
|
|
l $Ç ' Ö
|
|||
|
|
ž Øq² ! þ ú Ô < qÌ ì Ö¿
|
|||
|
|
ÉÔ ·
|
|||
|
|
Æ Ì ú" Ô $ $ Ö¿ø Ô 7$ •¢ª Ä� V$ . 5 k‘ l‘ [ ª \ c š) ¨) Ö
|
|||
|
|
û ¨) Ô) Ô ì* Ö¿©CÔ Ð × ’ � £ $£ h üÉ ! œ ›! ˜ Æ� – •
|
|||
|
|
E ü½ 0 Ö¿ Ä�Ô
|
|||
|
|
g
|
|||
|
|
w ~ ~" « Ä� —# •¢ ª Ä� ¹ À ‹ Äú
|
|||
|
|
l Ä� ¦ äÿ ˆ ý‡ä#?% ½‡ä?%
|
|||
|
|
% ÃÛÃÛ ManuallyDropÁ ÅÛ»¬ „ µÜÀ,�%*©C MÉZ& ©C
|
|||
|
|
©ä?% ýàÕ%N(
|
|||
|
|
°ä?% ˜ üü Ö¿ ©CÔ › õ — & ,üÀ Þ üï ¯ üÛ Ã üö ~ Ô Û â ` ý¹ƒR? ò©Cäý ýúɺ? ö©Cd˜
|
|||
|
|
©Cú4¥
|
|||
|
|
Ù À©CÜÒ
|
|||
|
|
ˆ îr úüµ
|
|||
|
|
9 ¤ š ³ ¼
|
|||
|
|
ÿÝ Î
|
|||
|
|
Ù Àúê ñ Êú
|
|||
|
|
Æúu ! ºùú6üÁ ® - rÌ
|
|||
|
|
ܲ Y ÛsúT� ò ÷\îÔ Ö ü\Ä�ÔÔ?ó þ † Ô ì É»õ ó Âùi ò ÷\Ä�Ôó " "" "ýÕàì? ÷©ClŒ ñ % ÛÉ”©C]Ÿä?%ýµ‚³Z% …©C5«ä?%ý¨ÃåN' Ý©CUÖƒZ'Ö ü\©CÔÔƒ ó) )þ* † Ô) Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
©CÔ ”Ö ‚� ± ÷ n ð# ú •¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜ª Ä� m Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ä�Ô ¾ ª Š Ä�
|
|||
|
|
©C ç ‚� è ‚� u–Ë? ²8 u à ðÄ�
|
|||
|
|
û Æ" Ô úÃ’ ž
|
|||
|
|
²8 ¾
|
|||
|
|
Ä� ~" Ô ú"ª "—• ?% É” ?%û Ò) Ô Ô) ¨) Ï8. dstÁ ß »‰ Ž c ¹æ Ê- �©C ¨ - �ú ¨ @ ‚ú ¨ Ë<Ñ ÀŽç ™<—
|
|||
|
|
|
|||
|
|
Ç©Cýªâ#?
|
|||
|
|
<Ÿ Î Ö
|
|||
|
|
ÑÛÑÛ † ÓÛ›Ý ÔÛ»Ý Íõƒ«%9 Ë
|
|||
|
|
+'
|
|||
|
|
|
|||
|
|
ð# ù
|
|||
|
|
Ö
|
|||
|
|
¨ – Àm¦ ¼¦
|
|||
|
|
È Ñ Ö
|
|||
|
|
ÀŽ Ç í Ö
|
|||
|
|
Ê Ç ñ% & ú Ô
|
|||
|
|
Æ ì Ö¿Ä�Ô °
|
|||
|
|
¿ Å ú" Ô $ $ Ö¿ø Ô 7$ •¢ª Ä� V$ ' . m½ n½ [ ª U \ š) ¨) Ö
|
|||
|
|
û ¨) Ô) Ô ì* Ö¿Ô É Ð ¾ É � $d ) Á [ Z! W Ã’ S R
|
|||
|
|
|
|||
|
|
¾ Ö¿ Ä�Ô
|
|||
|
|
[
|
|||
|
|
k r ~" « Ä� —# •¢ ª Ä� ´ † Ħ l Ä� ¡ ä« ´ ¼ % ¸ % ¿ % ÃÛÃÛ Õ“ ÅÛ»¬ „ µÜÀ,�%* « & © % ¦ ( ¢ % Ä ü¨ Ö¿ Ô Ç Ó o ' ,üìÞ ü›¯ ü‡Ã ü¢~ ² ¹ À C Ÿ òä© › ödÄ ±) Âú4Ñ Ù ÀÜþ ˆ îr úüá9 ¤ š ³ ¼
|
|||
|
|
ÿÝ Î
|
|||
|
|
Ù Àúê ñ Êú
|
|||
|
|
Æúu ! ºùú6– - â “ › £ “ Y Ûsú’ ò ÷\îÔ¦ Ö ü\Ä�ÔÔÐó þ † Ô } ÉL
|
|||
|
|
† „ Âùú ò ÷\Ä�Ô¼ " "" "‘ ÷l¸ }&% Ûÿ§Œ %‰ % …„ %� ' Ý| 'Ö ü\ÔÔ4 ó) )þ* † Ô) Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ô ”‚ Í \ ÷ Q ð# ¦œ Î †� Î ª ¡ Ä� & Í Í Ø ²8 u à ÅÄ� ßû ›+ Ô úÃ’ s ²8 “ Ä� ~" Ô ú"ª "À¨ % ÿ§ %û Ò) Ô Ô) ¨) Ï85 žž ‹ »ã Ž t ¹ü ý- � ¨ - �ú ¨ @ ‚ú ¨ Ë<Ñ ÀŽ¹ ™<—
|
|||
|
|
|
|||
|
|
ÇÒ øo‚8 ü‚7 ü— € – ²8 | { B Q
|
|||
|
|
—
|
|||
|
|
|
|||
|
|
—
|
|||
|
|
|
|||
|
|
|˜ Ö
|
|||
|
|
È # ü” @ 5 ‰ ’Ö
|
|||
|
|
ÀŽ ˆ ® u ñ% & é ƒ ‚ Ã’ { z
|
|||
|
|
* æ Ö¿ Ä�Ô
|
|||
|
|
\
|
|||
|
|
m t ~ « Ä� — •¢ ª Ä� ¯ ¶ o¹ ü‚8 l Ä� p¹ º 4À Ö
|
|||
|
|
à ~ ú
|
|||
|
|
Ô Æ ‹ ì Ö¿Ä�Ô
|
|||
|
|
N
|
|||
|
|
_ f ú Ô Ö¿ø Ô 7 •¢ª Ä� V É Ð ú [ ª ò ù š ¨ Ö
|
|||
|
|
û ¨ Ô Ô ì Ö¿îÔ f m ‡ ë ã ó , ü¬œ É Ð × ü Ý $Éà å õ ÂÆ�UÑ - ö Î Ö Þ Î Y ÛsúÍò ÷\îÔá Ö
|
|||
|
|
ü\Ä�ÔÔ ó þ † Ô¸ ɇÁ ¿ Âù5ò ÷\Ä�ÔÑ Ö ü\îÔÔù ó þ † Ô à ŒÌ Ä� $¸ œ 2 †� 1 ÷ 0 ª g Ä� Ž ²8 «Ã’ Éà DÄ� ^¨ —
|
|||
|
|
|
|||
|
|
û æ+ Ô úÃ’ ú²8 Ä� ~ Ô úª û Ò Ô Ô ¨ �G² Ž ¹- X ÀŽÞ ™<—
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
¸ Ç ¥ Ø ï 4 = Ö
|
|||
|
|
ÀŽ 3 Y ' ñ% & Ö
|
|||
|
|
¤
|
|||
|
|
> = :
|
|||
|
|
Ã’ 6 5
|
|||
|
|
|
|||
|
|
å
|
|||
|
|
¡ Ö¿ Ä�Ô ï ú Ô Ö¿ø Ô 7 •¢ª î V ( / ô n [ ª R
|
|||
|
|
Y š
|
|||
|
|
¨
|
|||
|
|
Ö
|
|||
|
|
û ¨ Ô Ô ì
|
|||
|
|
Ö¿Ä�Ô Ç Î
|
|||
|
|
Í # ç î ³ ' É - U J Q X G Y ÛsúE ò ÷\îÔX Ö ü\Ä�ÔÔ� ó þ
|
|||
|
|
† Ô - Éü 5 3 Âù© †� Äõ ÷ $Ô •¢˜¢ ™¢l š¢ˆ ›¢ œ¢[�¢ˆ e0<#˜ª î 5 à { ª v Ä� � ¨ —
|
|||
|
|
û æ+ Ô úª û Ò Ô Ô ¨ Ã’ X ²8 x �GÅ Ž ß ¹Ó Ö
|
|||
|
|
î ÀŽ ™<—
|
|||
|
|
¬ù" Ö
|
|||
|
|
|
|||
|
|
& �# . üÐ"@ ¹› ”à" ÞÆO ¬š% Ö
|
|||
|
|
|
|||
|
|
' ±% / üñ$@ ²® ”�% ºÇO äÕ v ŽJ w & �K 1 ÆK 8 ? „Û
|
|||
|
|
Œ � % Ô 0 œm 7 > ,-./í _4¢ †\º ÑÛ ˜,Ø Œ *ïTß Š +ü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
|
|||
|
|
|
|||
|
|
## Examples
|
|||
|
|
|
|||
|
|
```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`]
|
|||
|
|
| 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`])
|
|||
|
|
| Motor OS | `x86_64-unknown-motor` | [`RDRAND`]
|
|||
|
|
|
|||
|
|
Pull Requests that add support for new targets to `getrandom` are always welcome.
|
|||
|
|
|
|||
|
|
### WebAssembly support
|
|||
|
|
|
|||
|
|
This crate fully supports the [WASI] and [Emscripten] targets. However, the `wasm32-unknown-unknown`
|
|||
|
|
and `wasm64-unknown-unknown` targets (i.e. the target used by `wasm-pack`)
|
|||
|
|
are 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 these targets 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/64-unknown-unknown` using
|
|||
|
|
[`Crypto.getRandomValues`] via [`wasm-bindgen`], enable the `wasm_js` crate feature.
|
|||
|
|
|
|||
|
|
WARNING: We strongly recommend against enabling this feature in libraries (except for tests)
|
|||
|
|
since it is known to break non-Web WASM builds and further since the usage of `wasm-bindgen`
|
|||
|
|
causes significant bloat to `Cargo.lock` (on all targets).
|
|||
|
|
|
|||
|
|
The only exception to this rule: if your crate already unconditionally depends on `wasm-bindgen`
|
|||
|
|
or `js-sys` on "unknown" WASM targets then it's acceptable to enable this feature unconditionally.
|
|||
|
|
|
|||
|
|
### 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
|
|||
|
|
| `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])
|
|||
|
|
| `extern_impl` | All targets | `*` | Externally-provided custom implementation (see [externally implemented interface])
|
|||
|
|
|
|||
|
|
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.'cfg(target_os = "linux")']
|
|||
|
|
rustflags = ['--cfg', 'getrandom_backend="linux_getrandom"']
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
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.
|
|||
|
|
|
|||
|
|
### 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;
|
|||
|
|
|
|||
|
|
#[unsafe(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(())
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
#[unsafe(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)
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Externally Implemented Interface
|
|||
|
|
|
|||
|
|
Using the nightly-only feature [`extern_item_impls`] it is possible to provide
|
|||
|
|
a custom backend for `getrandom`, even to override an existing first-party implementation.
|
|||
|
|
First, enable the `extern_impl` opt-in backend to allow usage of this nightly feature.
|
|||
|
|
Then, you may provide implementations for `fill_uninit`, `u32`, and/or `u64`
|
|||
|
|
with an attribute macro from the `implementation` module.
|
|||
|
|
|
|||
|
|
[`extern_item_impls`]: https://github.com/rust-lang/rust/issues/125418
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
use core::mem::MaybeUninit;
|
|||
|
|
|
|||
|
|
#[cfg(getrandom_backend = "extern_impl")]
|
|||
|
|
#[getrandom::implementation::fill_uninit]
|
|||
|
|
fn my_fill_uninit_implementation(
|
|||
|
|
dest: &mut [MaybeUninit<u8>]
|
|||
|
|
) -> Result<(), getrandom::Error> {
|
|||
|
|
// ...
|
|||
|
|
Ok(())
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
For further details on what a suitable implementation for `fill_uninit` may look
|
|||
|
|
like, see [custom backend].
|
|||
|
|
|
|||
|
|
`getrandom` will provide a default implementation for `u32` and `u64`, but does
|
|||
|
|
not currently provide a default for `fill_uninit`, even if one is normally
|
|||
|
|
available for the current target. If no implementation is available,
|
|||
|
|
a compilation error will be raised with instructions for how to provide
|
|||
|
|
an implementation.
|
|||
|
|
|
|||
|
|
### 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.85 or later.
|
|||
|
|
|
|||
|
|
The most reliable way to get an MSRV-respecting behavior is to set
|
|||
|
|
`CARGO_RESOLVER_INCOMPATIBLE_RUST_VERSIONS=fallback` when doing
|
|||
|
|
`cargo update -p getrandom`, like so:
|
|||
|
|
```sh
|
|||
|
|
CARGO_RESOLVER_INCOMPATIBLE_RUST_VERSIONS=fallback cargo update -p getrandom
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## License
|
|||
|
|
|
|||
|
|
The `getrandom` library is distributed under either of
|
|||
|
|
|
|||
|
|
* [Apache License, Version 2.0][LICENSE-APACHE]
|
|||
|
|
* [MIT license][LICENSE-MIT]
|
|||
|
|
|
|||
|
|
at your option.
|
|||
|
|
|
|||
|
|
### Contribution
|
|||
|
|
|
|||
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|||
|
|
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
|
|||
|
|
dual licensed as above, without any additional terms or conditions.
|
|||
|
|
|
|||
|
|
[//]: # (badges)
|
|||
|
|
|
|||
|
|
[GitHub Actions]: https://github.com/rust-random/getrandom/actions?query=branch:master
|
|||
|
|
[Build Status]: https://github.com/rust-random/getrandom/actions/workflows/tests.yml/badge.svg?branch=master
|
|||
|
|
[crates.io]: https://crates.io/crates/getrandom
|
|||
|
|
[Crate]: https://img.shields.io/crates/v/getrandom
|
|||
|
|
[docs.rs]: https://docs.rs/getrandom
|
|||
|
|
[Documentation]: https://docs.rs/getrandom/badge.svg
|
|||
|
|
[deps.rs]: https://deps.rs/repo/github/rust-random/getrandom
|
|||
|
|
[Dependency Status]: https://deps.rs/repo/github/rust-random/getrandom/status.svg
|
|||
|
|
[Downloads]: https://img.shields.io/crates/d/getrandom
|
|||
|
|
[License]: https://img.shields.io/crates/l/getrandom
|
|||
|
|
|
|||
|
|
[//]: # (supported targets)
|
|||
|
|
|
|||
|
|
[1]: https://manned.org/getrandom.2
|
|||
|
|
[2]: https://manned.org/urandom.4
|
|||
|
|
[3]: https://www.unix.com/man-page/mojave/2/getentropy/
|
|||
|
|
[4]: https://www.unix.com/man-page/mojave/4/urandom/
|
|||
|
|
[5]: https://www.freebsd.org/cgi/man.cgi?query=getrandom&manpath=FreeBSD+12.0-stable
|
|||
|
|
[7]: https://man.openbsd.org/getentropy.2
|
|||
|
|
[8]: https://man.netbsd.org/sysctl.7
|
|||
|
|
[9]: https://leaf.dragonflybsd.org/cgi/web-man?command=getrandom
|
|||
|
|
[11]: https://docs.oracle.com/cd/E88353_01/html/E37841/getrandom-2.html
|
|||
|
|
[12]: https://illumos.org/man/2/getrandom
|
|||
|
|
[13]: https://github.com/emscripten-core/emscripten/pull/12240
|
|||
|
|
[14]: https://www.qnx.com/developers/docs/7.1/index.html#com.qnx.doc.neutrino.utilities/topic/r/random.html
|
|||
|
|
[15]: https://www.ibm.com/docs/en/aix/7.3?topic=files-random-urandom-devices
|
|||
|
|
[16]: https://man.netbsd.org/getrandom.2
|
|||
|
|
[17]: https://www.gnu.org/software/libc/manual/html_mono/libc.html#index-getrandom
|
|||
|
|
[18]: https://github.com/rust3ds/shim-3ds/commit/b01d2568836dea2a65d05d662f8e5f805c64389d
|
|||
|
|
[19]: https://github.com/vitasdk/newlib/blob/2d869fe47aaf02b8e52d04e9a2b79d5b210fd016/newlib/libc/sys/vita/getentropy.c
|
|||
|
|
[20]: https://github.com/cygwin/cygwin/blob/main/winsup/cygwin/libc/getentropy.cc
|
|||
|
|
|
|||
|
|
[`ProcessPrng`]: https://learn.microsoft.com/en-us/windows/win32/seccng/processprng
|
|||
|
|
[`RtlGenRandom`]: https://learn.microsoft.com/en-us/windows/win32/api/ntsecapi/nf-ntsecapi-rtlgenrandom
|