---
name: "aub"
section: "1"
platform: "linux"
package: "aub"
version: "2.2.1"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/aub"
---

# aub(1)

Assembles binary files from USENET

## NAME

aub — Assembles binary files from USENET

## SYNOPSIS

**aub** \[*option*\]

## DESCRIPTION

**aub** accesses news either remotely via the  NNTP protocol or locally, by scanning a news spool directory,  and searches for new pieces of split, encoded binaries that  have recently been received.  Binaries are expected to contain  subject lines conforming to de-facto Usenet standards; aub  may not be able to identify pieces of binaries which are not  named according to accepted conventional practice.  If new  binaries are found, aub retrieves, organizes and decodes them,  leaving the decoded files in a configurable location.

## OPTIONS

Most of aub's configuration is done in the it's main  configuration file, $HOME/.aubconf, which is required. Invoke  aub with the -M flag to learn about the structure of  configuration files.  This will also present a full discussion  of aub and its capabilities. aub understands the following  options, all of which are discussed in detail in the internal  documentation:

- **-c**

  Catch-up mode; binaries are processed but not  assembled.

- **-n**

  No-checkpoint mode; the user's .aubrc file is not  modified.

- **-d***N*

  Specifies the debug level that aub is to run at.

- **-m**

  Prints a summary of the manual.

- **-M**

  Prints the manual.

- **-C**

  Lists changes since the last version of aub.

- **-v**

  Print version number

## FILES

- **~/.aubconf**

  aub's main configuration file. This file is required for  aub to run at all. Read the **aubconf** 	     documentation or run **aub -M** to find out  more about the structure of this file.

- **~/.aubrc**

  Historical data maintained by and for  **aub** about which articles it has assembled  into files (or checked and decided to pass) and which it has  not. In the vast majority of cases you won't need to touch  this file

- **/usr/bin/perl**

  The Perl interpreter.

## ENVIRONMENT

- AUBDIR

  Default location for decoded binaries

- AUBDESC

  Default location for description file

- AUBHOOK

  Default hook program

- NNTPSERVER

  Potential NNTP server

- HOME

  Your home directory

## AUTHORS

Mark Stantz (No valid email address known)

Brandon Long blong@fiction.net

Avinash Chopde avinash@acm.org

Mako Hill mako@debian.org (responsible for  this document)

## COPYRIGHT

Copyright (c) 1992-2002 Mark Stantz, Brandon Long, Avinash  Chopde, Mako Hill

This code is offered as-is.  Anyone is welcome to make  improvements, provided that my notice of authorship is retained.  I accept no responsibility for loss or damage caused by this  program, nor do I accept responsibility for supporting  it.

## SEE ALSO

**[aubconf(1)](/aubconf/1.md)**; the  **INTRODUCING\_AUB** document
