about summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Schaefer <git@danielschaefer.me>2019-05-03T12·30+0200
committerDaniel Schaefer <git@danielschaefer.me>2019-05-03T15·23+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 0fb5261b384c..a87639a075a5 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>