amulecmd(1)
NAME
amulecmd - Console-based program to control aMule
SYNOPSIS
amulecmd [-h <host>] [-p <port>] [-P <password>] [-f <path>] [-q] [-v]
[-l <lang>] { [-w] | [-c <command>] }
amulecmd [--create-config-from=<path>]
amulecmd [--version]
amulecmd [--help]
DESCRIPTION
amulecmd is a console-based client to control aMule.
[ -h <host>, --host=<host> ]
Host where aMule is running (default: localhost). <host> might
be an IP address or a DNS name
[ -p <port>, --port=<port> ]
aMule's port for External Connections, as set in
Preferences->Remote Controls (default: 4712)
[ -P <password>, --password=<password> ]
External Connections password.
[ -f <path>, --config-file=<path> ]
Use the given configuration file. Default configuration file is
~/.aMule/remote.conf
[ -q, --quiet ]
Do not print any output to stdout.
[ -v, --verbose ]
Be verbose - show also debug messages.
[ -l <lang>, --locale=<lang> ]
Sets program locale (language). See the NOTES section for the
description of the <lang> parameter.
[ -w, --write-config ]
Write command line options to config file and exit
[ -c <command>, --command=<command> ]
Execute <command> as if it was entered at amulecmd's prompt and
exit.
[ --create-config-from=<path> ]
Create config file based upon <path>, which must point to a
valid aMule config file, and then exit.
[ -v, --version ]
Displays the current version number.
[ -h, --help ]
Prints a short usage description.
COMMANDS
All commands are case insensitive.
Add <eD2k-link> | <magnet-link>
Adds an eD2k-link or a magnet-link to the core.
The eD2k link to be added can be:
* a file link (ed2k://|file|...), it will be added to the download
queue;
* a server link (ed2k://|server|...), it will be added to the server
list;
* a serverlist link, in which case all servers in the list will be
added to the server list.
The magnet link must contain the eD2k hash and file length.
Cancel <hash> | <number>
Cancels the download specified by <hash> or <number>. To get the value
use show.
Connect [ kad | ed2k | <ip|name> ]
Connect to the network.
This will connect to all networks that are enabled in Preferences.
With the optional parameter you can specify which network to connect
to. Giving a server address in the form of IP:Port (where IP is either
a dotted decimal IPv4 address or a resolvable DNS name) aMule will
connect to that server only.
Disconnect [ ed2k | kad ]
Disconnect from all networks you are connected to, or just disconnect
from the specified network.
Download <number>
Start downloading a file.
The <number> of a file from the last search has to be given. Example:
`download 12' will start to download the file with the number 12 of the
previous search.
Exit
Disconnect from amule/amuled and quit amulecmd.
Get <what>
Get and display a preference value.
Available values for <what>:
BwLimits Get bandwidth limits.
IPFilter Get IPFilter preferences.
Help [ <command> ]
Prints a short usage description. If called without parameter, it
shows a list of available commands. If called with <command>, it shows
a short description of the given command.
Pause <hash> | <number>
Pauses the download specified by <hash> or <number>. To get the value
use show.
Priority <priority> <hash> | <number>
Set priority of a download specified by <hash> or <number>.
Available values for <priority>:
Auto Automatic priority.
High High priority.
Low Low priority.
Normal Normal priority.
Progress
Shows the progress of an on-going search.
Quit
A synonim of the exit command.
Reload <what>
Reloads a given object.
Available values for <what>:
Shared Reload shared files list.
IPFilter Reload IP filter tables.
Reset
Reset the log.
Results
Shows you the results of the last search.
Resume <hash> | <number>
Resumes the download specified by <hash> or <number>. To get the value
use show.
Search <type> <keyword>
Makes a search for the given <keyword>. A search type and a keyword to
search is mandatory to do this. Example: `search kad amule' performs a
kad search for `amule'.
Available search types:
Global Performs a global search.
Kad Performs a search on the Kademlia network.
Local Performs a local search.
Set <what>
Sets a given preferences value.
Available values for <what>:
BwLimits Set bandwidth limits.
IPFilter Set IPFilter preferences.
Show <what>
Shows upload/download queue, servers list or shared files list.
Available values for <what>:
DL Show download queue.
Log Show log.
Servers Show servers list.
UL Show upload queue.
Shutdown
Shutdown the remote running core (amule/amuled). This will also shut
down the text client, since it is unusable without a running core.
Statistics [ <number> ]
Show statistics tree.
The optional <number> in the range of 0-255 can be passed as argument
to this command, which tells how many entries of the client version
subtree should be shown. Passing 0, or omitting it means `unlimited'.
Example: `statistics 5' will show only the top 5 versions for each
client type.
Status
Show connection status, current up/download speeds, etc.
NOTES
Paths
For all options which take a <path> value, if the path contains no
directory part (i.e. just a plain filename), then it is considered to
be under the aMule configuration directory, ~/.aMule.
Languages
The <lang> parameter for the -l option has the following form:
lang[_LANG][.encoding][@modifier] where lang is the primary language,
LANG is a sublanguage/territory, encoding is the character set to use
and modifier allows the user to select a specific instance of
localization data within a single category.
For example, the following strings are valid:
de
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro
Though all the above strings are accepted as valid language
definitions, encoding and modifier are yet unused.
In addition to the format above, you can also specify full language
names in English - so -l german is also valid and is equal to -l de_DE.
When no locale is defined, either on command-line or in config file,
system default language will be used.
FILES
~/.aMule/remote.conf
EXAMPLE
Typically amulecmd will be first run as: amulecmd -h hostname -p ECport -P ECpassword -w or amulecmd --create-config-from=/home/username/.aMule/amule.conf These will save settings to $HOME/.aMule/remote.conf, and later you only need to type: amulecmd Of course, you don't have to follow this example.
REPORTING BUGS
Please report bugs either on our forum (http://forum.amule.org/), or in our bugtracker (http://bugs.amule.org/). Please do not report bugs in e-mail, neither to our mailing list nor directly to any team member.
COPYRIGHT
aMule and all of its related utilities are distributed under the GNU General Public License.
SEE ALSO
amule(1), amuled(1)
AUTHOR
This manpage was written by Vollstrecker <[email protected]>
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
