51 lines
		
	
	
	
		
			1.5 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			51 lines
		
	
	
	
		
			1.5 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
<refentry xmlns="http://docbook.org/ns/docbook"
 | 
						|
      xmlns:xlink="http://www.w3.org/1999/xlink"
 | 
						|
      xmlns:xi="http://www.w3.org/2001/XInclude"
 | 
						|
      version="5.0"
 | 
						|
      xml:id="sec-nix-pull">
 | 
						|
 | 
						|
<refmeta>
 | 
						|
  <refentrytitle>nix-pull</refentrytitle>
 | 
						|
  <manvolnum>1</manvolnum>
 | 
						|
  <refmiscinfo class="source">Nix</refmiscinfo>
 | 
						|
  <refmiscinfo class="version"><xi:include href="../version.txt" parse="text"/></refmiscinfo>
 | 
						|
</refmeta>
 | 
						|
 | 
						|
<refnamediv>
 | 
						|
  <refname>nix-pull</refname>
 | 
						|
  <refpurpose>pull substitutes from a network cache</refpurpose>
 | 
						|
</refnamediv>
 | 
						|
 | 
						|
<refsynopsisdiv>
 | 
						|
  <cmdsynopsis>
 | 
						|
    <command>nix-pull</command>
 | 
						|
    <arg choice='plain'><replaceable>url</replaceable></arg>
 | 
						|
  </cmdsynopsis>
 | 
						|
</refsynopsisdiv>
 | 
						|
 | 
						|
 | 
						|
<refsection><title>Description</title>
 | 
						|
 | 
						|
<para>The command <command>nix-pull</command> obtains a list of
 | 
						|
pre-built store paths from the URL <replaceable>url</replaceable>, and
 | 
						|
for each of these store paths, registers a substitute derivation that
 | 
						|
downloads and unpacks it into the Nix store.  This is used to speed up
 | 
						|
installations: if you attempt to install something that has already
 | 
						|
been built and stored into the network cache, Nix can transparently
 | 
						|
re-use the pre-built store paths.</para>
 | 
						|
 | 
						|
<para>The file at <replaceable>url</replaceable> must be compatible
 | 
						|
with the files created by <replaceable>nix-push</replaceable>.</para>
 | 
						|
 | 
						|
</refsection>
 | 
						|
 | 
						|
 | 
						|
<refsection><title>Examples</title>
 | 
						|
 | 
						|
<screen>
 | 
						|
$ nix-pull http://nix.cs.uu.nl/dist/nix/nixpkgs-0.5pre753/MANIFEST</screen>
 | 
						|
 | 
						|
</refsection>
 | 
						|
 | 
						|
 | 
						|
</refentry>
 |