sleeping_kangaroo12 0.0.1 → 0.0.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE.md +27 -0
- data/README.md +25 -0
- data/lib/sleeping_kangaroo12/version.rb +1 -1
- metadata +6 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: b4d2de10a5eb054f79c78f0582ad189c8cee1ac86bbe089b4adfd4c5f57c84d1
|
4
|
+
data.tar.gz: 70ebb4254f79085ca629764a7b141066a86e21a99b564b29da9055816c19c2e6
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 3704a7302ed0026463abed7510e748bb89cc9a956b9ef5c298f65f78ca38e6f8bf218a7e3e560731cf69f961d79f9e9073ca32314ed77af7ea36a809a366d946
|
7
|
+
data.tar.gz: 45d1e038d116ffe9c0848680c0062f33b31d1167c9f360a308890b7c9fef14c6caea48b6ecc1bd221bfdb5eedc3eae7a793aaa335c3a3115918194afe937cc63
|
data/LICENSE.md
ADDED
@@ -0,0 +1,27 @@
|
|
1
|
+
# BSD 3-Clause License
|
2
|
+
|
3
|
+
_Copyright © `2022`, `Sarun Rattanasiri`_
|
4
|
+
_All rights reserved._
|
5
|
+
|
6
|
+
Redistribution and use in source and binary forms, with or without modification,
|
7
|
+
are permitted provided that the following conditions are met:
|
8
|
+
|
9
|
+
* Redistributions of source code must retain the above copyright notice,
|
10
|
+
this list of conditions and the following disclaimer.
|
11
|
+
* Redistributions in binary form must reproduce the above copyright notice,
|
12
|
+
this list of conditions and the following disclaimer in the documentation
|
13
|
+
and/or other materials provided with the distribution.
|
14
|
+
* Neither the name of the copyright holder nor the names of its contributors
|
15
|
+
may be used to endorse or promote products derived from this software
|
16
|
+
without specific prior written permission.
|
17
|
+
|
18
|
+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
19
|
+
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
20
|
+
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
21
|
+
IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
|
22
|
+
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
23
|
+
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
24
|
+
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
25
|
+
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
26
|
+
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
27
|
+
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
data/README.md
CHANGED
@@ -61,6 +61,20 @@ And then execute:
|
|
61
61
|
|
62
62
|
$ bundle install
|
63
63
|
|
64
|
+
## Related to containers
|
65
|
+
|
66
|
+
OK, now, we have another issue since we detect CPU features on installation.
|
67
|
+
|
68
|
+
What if we want to build the container image, says Docker image, locally but deploy on a server.
|
69
|
+
Chances are our workstation is using more recent CPU than the server.
|
70
|
+
|
71
|
+
I would recommend recompilation on container starts, simply do:
|
72
|
+
~~~
|
73
|
+
bundle exec gem pristine sleeping_kangaroo12
|
74
|
+
~~~
|
75
|
+
before the command, you actually want to run.
|
76
|
+
This will trigger the recompilation of SleepingKangaroo12.
|
77
|
+
|
64
78
|
## Usage Examples
|
65
79
|
|
66
80
|
Test vectors stolen
|
@@ -122,6 +136,17 @@ digest = ::SleepingKangaroo12::Digest.new(key: 'secret', output_length: 1_000_00
|
|
122
136
|
# Output: "dc1fd53f85402e2b34fa92bd87593dd9c3fe6cc49d9db6c05dc0cf26c6a7e03f"
|
123
137
|
~~~
|
124
138
|
|
139
|
+
## About CPU Throttling
|
140
|
+
|
141
|
+
At the time of this writing, if you use a lot of AVX-512, your CPU would heat up significantly; this leads to frequency throttling.
|
142
|
+
|
143
|
+
If you plan to use KangarooTwelve heavily yet still have other functionalities impacted by lower CPU frequencies
|
144
|
+
(like [Cloudflare](https://blog.cloudflare.com/on-the-dangers-of-intels-frequency-scaling/)),
|
145
|
+
you may want to customize the build to prevent the throttling.
|
146
|
+
|
147
|
+
If that is the case, please check [konsolebox/digest-kangarootwelve-ruby](https://github.com/konsolebox/digest-kangarootwelve-ruby).
|
148
|
+
At the time of this writing, they offer customizable build; in contrast, SleepingKangaroo12 will focus on ease of use.
|
149
|
+
|
125
150
|
## License
|
126
151
|
|
127
152
|
SleepingKangaroo12 is released under the [BSD 3-Clause License](LICENSE.md). :tada:
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: sleeping_kangaroo12
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.0.
|
4
|
+
version: 0.0.2
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Sarun Rattanasiri
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2022-02-
|
11
|
+
date: 2022-02-16 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: ffi
|
@@ -62,6 +62,7 @@ extensions:
|
|
62
62
|
- ext/Rakefile
|
63
63
|
extra_rdoc_files: []
|
64
64
|
files:
|
65
|
+
- LICENSE.md
|
65
66
|
- README.md
|
66
67
|
- ext/Rakefile
|
67
68
|
- ext/binding/sleeping_kangaroo12.c
|
@@ -344,12 +345,12 @@ files:
|
|
344
345
|
- lib/sleeping_kangaroo12/build/platform.rb
|
345
346
|
- lib/sleeping_kangaroo12/digest.rb
|
346
347
|
- lib/sleeping_kangaroo12/version.rb
|
347
|
-
homepage: https://
|
348
|
+
homepage: https://github.com/the-cave/sleeping-kangaroo12
|
348
349
|
licenses:
|
349
350
|
- BSD-3-Clause
|
350
351
|
metadata:
|
351
|
-
homepage_uri: https://
|
352
|
-
source_code_uri: https://github.com/the-cave/sleeping-kangaroo12/tree/v0.0.
|
352
|
+
homepage_uri: https://github.com/the-cave/sleeping-kangaroo12
|
353
|
+
source_code_uri: https://github.com/the-cave/sleeping-kangaroo12/tree/v0.0.2
|
353
354
|
post_install_message:
|
354
355
|
rdoc_options: []
|
355
356
|
require_paths:
|