aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Schaefer <git@danielschaefer.me>2019-05-03 14:30:29 +0200
committerDaniel Schaefer <git@danielschaefer.me>2019-05-03 17:23:36 +0200
commit3f192ac80ca421888c668896b63485486e1397ae (patch)
tree128bbf3ee807b44498ac3cd256973a2bb455127a /doc
parentf9a2ea44867cd1dbb408bca4df0ced806137b7f7 (diff)
Add builtins.hashFile
For text files it is possible to do it like so: `builtins.hashString "sha256" (builtins.readFile /tmp/a)` but that doesn't work for binary files. With builtins.hashFile any kind of file can be conveniently hashed.
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/expressions/builtins.xml13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/manual/expressions/builtins.xml b/doc/manual/expressions/builtins.xml
index 0fb5261b3..a87639a07 100644
--- a/doc/manual/expressions/builtins.xml
+++ b/doc/manual/expressions/builtins.xml
@@ -705,6 +705,19 @@ builtins.genList (x: x * x) 5
</varlistentry>
+ <varlistentry xml:id='builtin-hashFile'>
+ <term><function>builtins.hashFile</function>
+ <replaceable>type</replaceable> <replaceable>p</replaceable></term>
+
+ <listitem><para>Return a base-16 representation of the
+ cryptographic hash of the file at path <replaceable>p</replaceable>. The
+ hash algorithm specified by <replaceable>type</replaceable> must
+ be one of <literal>"md5"</literal>, <literal>"sha1"</literal>,
+ <literal>"sha256"</literal> or <literal>"sha512"</literal>.</para></listitem>
+
+ </varlistentry>
+
+
<varlistentry xml:id='builtin-head'>
<term><function>builtins.head</function>
<replaceable>list</replaceable></term>