Urbit Developers
  • Hoon

    • Overview
    • Cheat Sheet
    • Irregular forms
    • Hoon Errors
    • Hoon Style Guide
    • Basic Types
    • Advanced Types
    • Auras
    • Arvo
    • Standard Library

      • 1a: Basic Arithmetic
      • 1b: Tree Addressing
      • 1c: Molds and Mold-Builders
      • 2a: Unit Logic
      • 2b: List Logic
      • 2c: Bit Arithmetic
      • 2d: Bit Logic
      • 2e: Insecure Hashing
      • 2f: Noun Ordering
      • 2g: Unsigned Powers
      • 2h: Set Logic
      • 2i: Map Logic
      • 2j: Jar and Jug Logic
      • 2k: Queue Logic
      • 2l: Container from Container
      • 2m: Container from Noun
      • 2n: Functional Hacks
      • 2o: Normalizing Containers
      • 2p: Serialization
      • 2q: Molds and Mold-Builders
      • 3a: Modular and Signed Ints
      • 3b: Floating Point
      • 3c: Urbit Time
      • 3d: SHA Hash Family
      • 3e: AES encryption (Removed)
      • 3f: Scrambling
      • 3g: Molds and Mold-Builders
      • 4a: Exotic Bases
      • 4b: Text Processing
      • 4c: Tank Printer
      • 4d: Parsing (Tracing)
      • 4e: Parsing (Combinators)
      • 4f: Parsing (Rule-Builders)
      • 4g: Parsing (Outside Caller)
      • 4h: Parsing (ASCII Glyphs)
      • 4i: Parsing (Useful Idioms)
      • 4j: Parsing (Bases and Base Digits)
      • 4k: Atom Printing
      • 4l: Atom Parsing
      • 4m: Formatting Functions
      • 4n: Virtualization
      • 4o: Molds
      • 5a: Compiler Utilities
      • 5b: Macro Expansion
      • 5c: Compiler Backend & Prettyprinter
      • 5d: Parser
      • 5e: Molds and mold builders
      • 5f: Profiling support
      • Runes

        • Constants (Atoms and Strings)
        • + lus · Arms
        • | bar · Cores
        • $ buc · Structures
        • % cen · Calls
        • : col · Cells
        • . dot · Nock
        • / fas · Imports
        • ^ ket · Casts
        • ; mic · Make
        • ~ sig · Hints
        • = tis · Subject
        • ? wut · Conditionals
        • ! zap · Wild
        • --, == Terminators
        • Limbs and wings

          • Limbs
          • Wings
          • Zuse

            • 2d(1-5): To JSON, Wains
            • 2d(6): From JSON
            • 2d(7): From JSON (unit)
            • 2e(2-3): Print & Parse JSON
            • 2m: Ordered Maps
          • Arvo

            • Overview
            • Ames

              • Overview
              • Cryptography
              • API Reference
              • Scry Reference
              • Data Types
              • Behn

                • Overview
                • API Reference
                • Scry Reference
                • Examples
                • Clay

                  • Overview
                  • Architecture
                  • Using Clay
                  • Data Types
                  • Scry Reference
                  • API Reference
                  • Examples
                  • Marks

                    • Overview
                    • Writing Marks
                    • Using Marks
                    • Examples
                  • Dill

                    • Overview
                    • API Reference
                    • Scry Reference
                    • Data Types
                    • Eyre

                      • Overview
                      • External API Reference
                      • Internal API Reference
                      • Scry Reference
                      • Data Types
                      • Guide
                      • Gall

                        • Overview
                        • API Reference
                        • Data Types
                        • Threads Reference
                        • Iris

                          • Overview
                          • API Reference
                          • Data Types
                          • Example
                          • Jael

                            • Overview
                            • API Reference
                            • Scry Reference
                            • Data Types
                            • Examples
                            • Khan

                              • Overview
                              • API Reference
                              • Data Types
                              • Example
                              • Threads

                                • Overview
                                • HTTP API
                                • Reference
                                • Gall

                                  • Start Thread
                                  • Take Result
                                  • Take Facts
                                  • Stop Thread
                                  • Poke Thread
                                  • Examples

                                    • Fetch JSON
                                    • Child Thread
                                    • Main-loop
                                    • Poke Agent
                                    • Scry
                                    • Take Fact
                                  • Concepts

                                    • Scries
                                    • Subscriptions
                                    • Tutorials

                                      • Move Trace
                                      • Reference

                                        • Cryptography
                                        • Filesystem Hierarchy
                                      • Nock

                                        • Nock Definition
                                        • Explanation
                                        • Example
                                        • Implementations
                                        • Vere

                                          • C Runtime System
                                          • Land of Nouns
                                          • API overview by prefix
                                          • C in Urbit
                                          • Writing Jets
                                          • Cryptography
                                          • Azimuth

                                            • Overview
                                            • Urbit HD Wallet
                                            • Azimuth Data Flow
                                            • Azimuth.eth
                                            • Ecliptic.eth
                                            • Advanced Azimuth Tools
                                            • Life and Rift
                                            • Layer 2

                                              • Layer 2 Overview
                                              • Layer 2 Actions
                                              • Transaction Format
                                              • Rollers
                                              • Roller HTTP RPC-API
                                              • Custom Roller Tutorial
                                            • Glossary

                                              • Agent
                                              • Ames
                                              • API
                                              • Aqua
                                              • Arm
                                              • Arvo
                                              • Atom
                                              • Aura
                                              • Aural ASCII
                                              • Azimuth
                                              • Battery
                                              • Behn
                                              • Bowl
                                              • Bridge
                                              • Bunt
                                              • Card
                                              • Case
                                              • Cask
                                              • Cell
                                              • Censures
                                              • Claims
                                              • Clay
                                              • Cold atom
                                              • Comet
                                              • Commit
                                              • Cons
                                              • Context
                                              • Cord
                                              • Core
                                              • Delegated Sending
                                              • Desk
                                              • Dill
                                              • Document Proposal
                                              • Dojo
                                              • Door
                                              • Double-boot
                                              • Dry Gate
                                              • Duct
                                              • Ecliptic
                                              • Entropy
                                              • Event Log
                                              • Eyre
                                              • Face
                                              • Fact
                                              • Foo Bar Baz
                                              • Galaxy
                                              • Gall
                                              • Garden
                                              • Gate
                                              • Generator
                                              • Gift
                                              • Glob
                                              • HD Wallet
                                              • Helm
                                              • Hood
                                              • Hoon
                                              • Invite Tree
                                              • Iris
                                              • Jael
                                              • Jet
                                              • Kelvin versioning
                                              • Kelvin versioning
                                              • Keyfile
                                              • Keywords
                                              • Khan
                                              • Kiln
                                              • Landscape
                                              • Leg
                                              • List
                                              • Loobean
                                              • Lull
                                              • Mark
                                              • Metals
                                              • Mold
                                              • Monad
                                              • Moon
                                              • Move
                                              • Nock
                                              • Noun
                                              • ~
                                              • OTA Updates
                                              • Path Prefix
                                              • Path
                                              • @p
                                              • Payload
                                              • Peek
                                              • pH
                                              • Pier
                                              • Pill
                                              • Planet
                                              • Poke
                                              • Proxies
                                              • Replay
                                              • Factory Reset
                                              • Roller
                                              • Naive rollups
                                              • Rune
                                              • Runtime
                                              • Sail
                                              • Sample
                                              • Scry
                                              • Senate
                                              • Ship
                                              • Slam
                                              • Spider
                                              • Sponsor
                                              • Star
                                              • String
                                              • Subject Oriented Programming
                                              • Subject
                                              • Subscription
                                              • Tape
                                              • Thread
                                              • Trap
                                              • Udon
                                              • Upgrade Proposal
                                              • Userspace
                                              • Vane
                                              • Vase
                                              • Vere
                                              • Voting
                                              • Warm atom
                                              • Wet Gate
                                              • Wing
                                              • Wire
                                              • Wrapper
                                              • ~zod
                                              • Zuse
                                              • Additional

                                                • Cryptography
                                                • Mips (Maps of Maps)
                                                • Software Distribution

                                                  • Overview
                                                  • Docket File
                                                  • Glob
                                                Urbit Developers
                                                • Hoon

                                                  • Overview
                                                  • Cheat Sheet
                                                  • Irregular forms
                                                  • Hoon Errors
                                                  • Hoon Style Guide
                                                  • Basic Types
                                                  • Advanced Types
                                                  • Auras
                                                  • Arvo
                                                  • Standard Library

                                                    • 1a: Basic Arithmetic
                                                    • 1b: Tree Addressing
                                                    • 1c: Molds and Mold-Builders
                                                    • 2a: Unit Logic
                                                    • 2b: List Logic
                                                    • 2c: Bit Arithmetic
                                                    • 2d: Bit Logic
                                                    • 2e: Insecure Hashing
                                                    • 2f: Noun Ordering
                                                    • 2g: Unsigned Powers
                                                    • 2h: Set Logic
                                                    • 2i: Map Logic
                                                    • 2j: Jar and Jug Logic
                                                    • 2k: Queue Logic
                                                    • 2l: Container from Container
                                                    • 2m: Container from Noun
                                                    • 2n: Functional Hacks
                                                    • 2o: Normalizing Containers
                                                    • 2p: Serialization
                                                    • 2q: Molds and Mold-Builders
                                                    • 3a: Modular and Signed Ints
                                                    • 3b: Floating Point
                                                    • 3c: Urbit Time
                                                    • 3d: SHA Hash Family
                                                    • 3e: AES encryption (Removed)
                                                    • 3f: Scrambling
                                                    • 3g: Molds and Mold-Builders
                                                    • 4a: Exotic Bases
                                                    • 4b: Text Processing
                                                    • 4c: Tank Printer
                                                    • 4d: Parsing (Tracing)
                                                    • 4e: Parsing (Combinators)
                                                    • 4f: Parsing (Rule-Builders)
                                                    • 4g: Parsing (Outside Caller)
                                                    • 4h: Parsing (ASCII Glyphs)
                                                    • 4i: Parsing (Useful Idioms)
                                                    • 4j: Parsing (Bases and Base Digits)
                                                    • 4k: Atom Printing
                                                    • 4l: Atom Parsing
                                                    • 4m: Formatting Functions
                                                    • 4n: Virtualization
                                                    • 4o: Molds
                                                    • 5a: Compiler Utilities
                                                    • 5b: Macro Expansion
                                                    • 5c: Compiler Backend & Prettyprinter
                                                    • 5d: Parser
                                                    • 5e: Molds and mold builders
                                                    • 5f: Profiling support
                                                    • Runes

                                                      • Constants (Atoms and Strings)
                                                      • + lus · Arms
                                                      • | bar · Cores
                                                      • $ buc · Structures
                                                      • % cen · Calls
                                                      • : col · Cells
                                                      • . dot · Nock
                                                      • / fas · Imports
                                                      • ^ ket · Casts
                                                      • ; mic · Make
                                                      • ~ sig · Hints
                                                      • = tis · Subject
                                                      • ? wut · Conditionals
                                                      • ! zap · Wild
                                                      • --, == Terminators
                                                      • Limbs and wings

                                                        • Limbs
                                                        • Wings
                                                        • Zuse

                                                          • 2d(1-5): To JSON, Wains
                                                          • 2d(6): From JSON
                                                          • 2d(7): From JSON (unit)
                                                          • 2e(2-3): Print & Parse JSON
                                                          • 2m: Ordered Maps
                                                        • Arvo

                                                          • Overview
                                                          • Ames

                                                            • Overview
                                                            • Cryptography
                                                            • API Reference
                                                            • Scry Reference
                                                            • Data Types
                                                            • Behn

                                                              • Overview
                                                              • API Reference
                                                              • Scry Reference
                                                              • Examples
                                                              • Clay

                                                                • Overview
                                                                • Architecture
                                                                • Using Clay
                                                                • Data Types
                                                                • Scry Reference
                                                                • API Reference
                                                                • Examples
                                                                • Marks

                                                                  • Overview
                                                                  • Writing Marks
                                                                  • Using Marks
                                                                  • Examples
                                                                • Dill

                                                                  • Overview
                                                                  • API Reference
                                                                  • Scry Reference
                                                                  • Data Types
                                                                  • Eyre

                                                                    • Overview
                                                                    • External API Reference
                                                                    • Internal API Reference
                                                                    • Scry Reference
                                                                    • Data Types
                                                                    • Guide
                                                                    • Gall

                                                                      • Overview
                                                                      • API Reference
                                                                      • Data Types
                                                                      • Threads Reference
                                                                      • Iris

                                                                        • Overview
                                                                        • API Reference
                                                                        • Data Types
                                                                        • Example
                                                                        • Jael

                                                                          • Overview
                                                                          • API Reference
                                                                          • Scry Reference
                                                                          • Data Types
                                                                          • Examples
                                                                          • Khan

                                                                            • Overview
                                                                            • API Reference
                                                                            • Data Types
                                                                            • Example
                                                                            • Threads

                                                                              • Overview
                                                                              • HTTP API
                                                                              • Reference
                                                                              • Gall

                                                                                • Start Thread
                                                                                • Take Result
                                                                                • Take Facts
                                                                                • Stop Thread
                                                                                • Poke Thread
                                                                                • Examples

                                                                                  • Fetch JSON
                                                                                  • Child Thread
                                                                                  • Main-loop
                                                                                  • Poke Agent
                                                                                  • Scry
                                                                                  • Take Fact
                                                                                • Concepts

                                                                                  • Scries
                                                                                  • Subscriptions
                                                                                  • Tutorials

                                                                                    • Move Trace
                                                                                    • Reference

                                                                                      • Cryptography
                                                                                      • Filesystem Hierarchy
                                                                                    • Nock

                                                                                      • Nock Definition
                                                                                      • Explanation
                                                                                      • Example
                                                                                      • Implementations
                                                                                      • Vere

                                                                                        • C Runtime System
                                                                                        • Land of Nouns
                                                                                        • API overview by prefix
                                                                                        • C in Urbit
                                                                                        • Writing Jets
                                                                                        • Cryptography
                                                                                        • Azimuth

                                                                                          • Overview
                                                                                          • Urbit HD Wallet
                                                                                          • Azimuth Data Flow
                                                                                          • Azimuth.eth
                                                                                          • Ecliptic.eth
                                                                                          • Advanced Azimuth Tools
                                                                                          • Life and Rift
                                                                                          • Layer 2

                                                                                            • Layer 2 Overview
                                                                                            • Layer 2 Actions
                                                                                            • Transaction Format
                                                                                            • Rollers
                                                                                            • Roller HTTP RPC-API
                                                                                            • Custom Roller Tutorial
                                                                                          • Glossary

                                                                                            • Agent
                                                                                            • Ames
                                                                                            • API
                                                                                            • Aqua
                                                                                            • Arm
                                                                                            • Arvo
                                                                                            • Atom
                                                                                            • Aura
                                                                                            • Aural ASCII
                                                                                            • Azimuth
                                                                                            • Battery
                                                                                            • Behn
                                                                                            • Bowl
                                                                                            • Bridge
                                                                                            • Bunt
                                                                                            • Card
                                                                                            • Case
                                                                                            • Cask
                                                                                            • Cell
                                                                                            • Censures
                                                                                            • Claims
                                                                                            • Clay
                                                                                            • Cold atom
                                                                                            • Comet
                                                                                            • Commit
                                                                                            • Cons
                                                                                            • Context
                                                                                            • Cord
                                                                                            • Core
                                                                                            • Delegated Sending
                                                                                            • Desk
                                                                                            • Dill
                                                                                            • Document Proposal
                                                                                            • Dojo
                                                                                            • Door
                                                                                            • Double-boot
                                                                                            • Dry Gate
                                                                                            • Duct
                                                                                            • Ecliptic
                                                                                            • Entropy
                                                                                            • Event Log
                                                                                            • Eyre
                                                                                            • Face
                                                                                            • Fact
                                                                                            • Foo Bar Baz
                                                                                            • Galaxy
                                                                                            • Gall
                                                                                            • Garden
                                                                                            • Gate
                                                                                            • Generator
                                                                                            • Gift
                                                                                            • Glob
                                                                                            • HD Wallet
                                                                                            • Helm
                                                                                            • Hood
                                                                                            • Hoon
                                                                                            • Invite Tree
                                                                                            • Iris
                                                                                            • Jael
                                                                                            • Jet
                                                                                            • Kelvin versioning
                                                                                            • Kelvin versioning
                                                                                            • Keyfile
                                                                                            • Keywords
                                                                                            • Khan
                                                                                            • Kiln
                                                                                            • Landscape
                                                                                            • Leg
                                                                                            • List
                                                                                            • Loobean
                                                                                            • Lull
                                                                                            • Mark
                                                                                            • Metals
                                                                                            • Mold
                                                                                            • Monad
                                                                                            • Moon
                                                                                            • Move
                                                                                            • Nock
                                                                                            • Noun
                                                                                            • ~
                                                                                            • OTA Updates
                                                                                            • Path Prefix
                                                                                            • Path
                                                                                            • @p
                                                                                            • Payload
                                                                                            • Peek
                                                                                            • pH
                                                                                            • Pier
                                                                                            • Pill
                                                                                            • Planet
                                                                                            • Poke
                                                                                            • Proxies
                                                                                            • Replay
                                                                                            • Factory Reset
                                                                                            • Roller
                                                                                            • Naive rollups
                                                                                            • Rune
                                                                                            • Runtime
                                                                                            • Sail
                                                                                            • Sample
                                                                                            • Scry
                                                                                            • Senate
                                                                                            • Ship
                                                                                            • Slam
                                                                                            • Spider
                                                                                            • Sponsor
                                                                                            • Star
                                                                                            • String
                                                                                            • Subject Oriented Programming
                                                                                            • Subject
                                                                                            • Subscription
                                                                                            • Tape
                                                                                            • Thread
                                                                                            • Trap
                                                                                            • Udon
                                                                                            • Upgrade Proposal
                                                                                            • Userspace
                                                                                            • Vane
                                                                                            • Vase
                                                                                            • Vere
                                                                                            • Voting
                                                                                            • Warm atom
                                                                                            • Wet Gate
                                                                                            • Wing
                                                                                            • Wire
                                                                                            • Wrapper
                                                                                            • ~zod
                                                                                            • Zuse
                                                                                            • Additional

                                                                                              • Cryptography
                                                                                              • Mips (Maps of Maps)
                                                                                              • Software Distribution

                                                                                                • Overview
                                                                                                • Docket File
                                                                                                • Glob
                                                                                              Reference/Arvo/Dill

                                                                                              API Reference

                                                                                              In this document we describe the public interface for Dill. Namely, we describe each task that Dill can be passed, and which gift(s) Dill can give in return.

                                                                                              %belt

                                                                                              [%belt p=belt]

                                                                                              Terminal input.

                                                                                              The runtime sends a %belt task to Dill whenever there is input in the terminal, such as a keystroke.

                                                                                              The $belt in p contains the input such as which key was pressed.

                                                                                              Dill will convert the $belt into a $dill-belt and %poke the session handler (typically drum) with it.

                                                                                              This task would not typically be used from userspace.

                                                                                              Returns

                                                                                              Dill returns no gift in response to a %belt task.

                                                                                              %blew

                                                                                              [%blew p=blew]

                                                                                              Terminal resized.

                                                                                              The runtime passes Dill a %blew task whenever the terminal is resized.

                                                                                              The $blew specifies the new dimensions.

                                                                                              Dill will convert the $blew into a %rez $dill-belt and %pokes the session handler (typically drum) with it.

                                                                                              This task would not typically be used from userspace.

                                                                                              Returns

                                                                                              Dill returns no gift in response to a %blew task.

                                                                                              %boot

                                                                                              [%boot lit=? p=*]

                                                                                              This task is used only once, when Arvo first enters the adult stage. Dill is technically the first vane to be activated, via the %boot task, which then sends Jael (considered the "true" first vane) the %dawn or %fake task wrapped in the %boot task. Jael then goes on to call %init tasks for other vanes (including Dill).

                                                                                              lit specifies whether to boot in lite mode. p is either a %dawn or %fake task:jael. %dawn is for an ordinary boot and %fake is for booting a fake ship.

                                                                                              This task would not be used from userspace.

                                                                                              Returns

                                                                                              Dill returns no gift in response to a %boot task, but it will %pass the wrapped %dawn or %fake task to Jael.

                                                                                              %crop

                                                                                              [%crop p=@ud]

                                                                                              Trim kernel state.

                                                                                              This task is the same as the %trim task. Like %trim, Dill does nothing with it.

                                                                                              Returns

                                                                                              Dill returns no gift in response to a %crop task.

                                                                                              %crud

                                                                                              [%crud p=@tas q=(list tank)]

                                                                                              Print error.

                                                                                              Dill prints the given error to the terminal. The verbosity for the particular @tas error tag specified in p is determined by the level set by a %knob task - either %hush, %soft or %loud. The default is %loud, where it will print the full (list tank) specified in q. See %knob for details of verbosity levels.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %crud task.

                                                                                              %flee

                                                                                              [%flee session=~]

                                                                                              Unwatch a session to which you've previously subscribed with %view.

                                                                                              The ability to specify a session is not yet implemented in Dill, so session is always ~, the default session.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %flee task.

                                                                                              %flog

                                                                                              [%flog p=flog]

                                                                                              A %flog task is a wrapper over a task sent by another vane. Dill removes the wrapper and sends the bare task to itself over the default duct.

                                                                                              A %flog task takes a $flog as its argument. A $flog is a subset of Dill's tasks.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %flog task.

                                                                                              %flow

                                                                                              [%flow p=@tas q=(list gill:gall)]

                                                                                              Terminal config.

                                                                                              This task is not used.

                                                                                              %hail

                                                                                              [%hail ~]

                                                                                              Refresh.

                                                                                              Dill converts a %hail task into a %hey $dill-belt and %pokes the session handler (typically drum) with it to handle the refresh.

                                                                                              This task would not be used from userspace.

                                                                                              Returns

                                                                                              Dill returns no gift in response to a %hail task.

                                                                                              %heft

                                                                                              [%heft ~]

                                                                                              Produce memory report.

                                                                                              When Dill receives a %heft task it passes Arvo a %whey waif to obtain a memory report and prints it to the terminal.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %heft task.

                                                                                              %hook

                                                                                              [%hook ~]

                                                                                              This terminal hung up.

                                                                                              This task is not used.

                                                                                              %harm

                                                                                              [%harm ~]

                                                                                              All terminals hung up.

                                                                                              This task is not used.

                                                                                              %init

                                                                                              [%init ~]

                                                                                              This task is called only once, when Arvo first enters the adult stage. It performs initial setup for Dill, such as setting the width of the console.

                                                                                              Note that this is not actually the first task passed to Dill - see %boot.

                                                                                              This task would not be used from userspace.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %init task.

                                                                                              %meld

                                                                                              [%meld ~]

                                                                                              Deduplicate persistent state.

                                                                                              Dill asks the runtime to perform the memory deduplication.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %meld task.

                                                                                              %noop

                                                                                              [%noop ~]

                                                                                              No operation.

                                                                                              A %noop task does nothing, as the name implies.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %noop task.

                                                                                              %pack

                                                                                              [%pack ~]

                                                                                              Defragment persistent state.

                                                                                              Dill asks the runtime to perform the defragmentation.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %meld task.

                                                                                              %talk

                                                                                              [%talk p=tank]

                                                                                              This task is not used.

                                                                                              %text

                                                                                              [%text p=tape]

                                                                                              Print tape to terminal.

                                                                                              Upon receiving a %text task, Dill will convert the tape given in p to a (list @c) and give it to the runtime in a %blit gift including a %lin $blit.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %text task, but it does give a %blit gift to the runtime which looks like:

                                                                                              [%blit p=(list blit)]

                                                                                              %view

                                                                                              [%view session=~]

                                                                                              Watch session.

                                                                                              A %view task subscribes for a copy of all %blit gifts which Dill %gives for the default session. This task is used by the %herm app so it can convert the $blits to JSON and render them in the web terminal.

                                                                                              The ability to specify a session is not yet implemented in Dill, so session is always ~, the default session.

                                                                                              Returns

                                                                                              Dill will %give a copy of all %blits for the default session. A %blit gift is:

                                                                                              [%blit p=(list blit)]

                                                                                              %trim

                                                                                              [%trim p=@ud]

                                                                                              %trim is a common vane task used to reduce memory usage. It does nothing for Dill because Dill only keeps a minimal necessary state.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %trim task.

                                                                                              %vega

                                                                                              [%vega ~]

                                                                                              This is a common vane task used to inform the vane that the kernel has been upgraded. Dill does not do anything in response to this.

                                                                                              This task would not be used from userspace.

                                                                                              Returns

                                                                                              Dill returns no gift in response to a %vega task.

                                                                                              %verb

                                                                                              [%verb ~]

                                                                                              This task toggles verbose mode for all of Arvo, which is located here since Dill is the vane that prints errors. To be precise, %verb toggles the laconic bit lac in the Arvo state by passing a %verb waif to Arvo.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %verb task.

                                                                                              %knob

                                                                                              [%knob tag=term level=?(%hush %soft %loud)]

                                                                                              %knob sets the verbosity level for each error tag. The error tag can be any @tas. The given tag and level will be added to Dill's veb which maps tags to levels. Subsequent %crud tasks will then print with the specified verbosity.

                                                                                              The levels behave like so:

                                                                                              • %hush - Completely silent, print nothing.
                                                                                              • %soft - Just print crud: %error-tag event failed, ignore any tang given in the %crud.
                                                                                              • %loud - Print the %soft message as well as the full tang given in the %crud task.

                                                                                              Returns

                                                                                              Dill does not return a gift in response to a %knob task.

                                                                                              <-

                                                                                              Overview

                                                                                              Scry Reference

                                                                                              ->

                                                                                              Edit this page on GitHub

                                                                                              Last modified March 17, 2023