GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
starpkg(1) FreeBSD General Commands Manual starpkg(1)

starpkg - convert a StarPlot data set to StarPlot file format

starpkg [ --dataset ] data-set [ --dest destination ]
starpkg --recurse input-dir [ --dest destination ]

On the StarPlot web site are available some packages of data that include both an original data file from NASA, and also a specification file. These packages are referred to as "data sets", from which starconvert(1) can produce a data file in StarPlot format. For ease of use, this should be done via the starpkg shell script.

Assuming that data-set is a valid StarPlot data set (either in tar.gz format or a directory resulting from uncompressing the tar.gz file), the `starpkg --dataset' command converts it to a StarPlot-formatted data file. Note that the `--dataset' flag is optional, and the name of the input data set may be specified without it. In order to be a valid StarPlot data set, a directory or tar.gz file must contain at least a valid specification file whose name ends with `.spec' and a flat text data file named `catalog.dat'.

If the `--dest' option is omitted, the default location of the output file is the first of the directories /usr/local/share/starplot, $PWD, $HOME in which the user has write permissions. If `--dest' is omitted or destination is a directory, the name of the output file will by default be ${specfilename%.spec}.stars. For instance, a data set containing gliese.3.spec will produce a file named gliese.3.stars.

The `starpkg --recurse' form of the command executes the above action for every StarPlot data set contained in input-dir, placing the resulting StarPlot data files to the directory destination. (If the --dest option is omitted, the default destination directory is chosen as above.) This form of the starpkg command is most useful when a new version of StarPlot has been installed and you wish to regenerate all StarPlot data files from data sets using the new starconvert program.

--dataset, -s
Specify a directory or tar.gz file to use as a StarPlot data set.
--dest, -d
Specify the file or directory in which to output StarPlot-format data files.
--quiet, -q
Print only fatal errors to the terminal.
--recurse, -r
Specify a directory in which to search for StarPlot data sets.
--starconvert-option option
Pass option through to starconvert. If you wish to pass more than one option (or an option that takes a following argument), you should give this flag multiple times, once for each starconvert option or argument.
--verbose, -v
Print all starconvert output to the terminal.

starplot(1), starconvert(1)

Copyright © 2000-2002 under the GNU GPL by Kevin B. McCarty <starplot@starplot.org>. The StarPlot web page is at www.starplot.org.
Nov 2002

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.