.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "BPCP 1"
.TH BPCP 1 "2016-07-07" "perl v5.24.1" "CFDP executables"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
bpcp \- A remote copy utility for delay tolerant networks utilizing
NASA JPL's Interplanetary Overlay Network (ION)
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBbpcp\fR [\-dqr | \-v] [\-L \fIbundle_lifetime\fR] [\-C \fIcustody_on/off\fR] 
[\-S \fIclass_of_service\fR] [\fIhost1\fR:]\fIfile1\fR ... [\fIhost2\fR:]\fIfile2\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBbpcp\fR copies files between hosts utilizing \s-1NASA JPL\s0's Interplanetary
Overlay Network (\s-1ION\s0) to provide a delay tolerant network. File copies
from local to remote, remote to local, or remote to remote are permitted.
\&\fBbpcp\fR depends on \s-1ION\s0 to do any authentication or encryption of file transfers.
All covergence layers over which \fBbpcp\fR runs \s-1MUST\s0 be reliable.
.PP
The options are permitted as follows:
.IP "\fB \-d\fR	Debug output. Repeat for increased verbosity." 5
.IX Item " -d Debug output. Repeat for increased verbosity."
.PD 0
.IP "\fB \-q\fR	Quiet. Do not output status messages." 5
.IX Item " -q Quiet. Do not output status messages."
.IP "\fB \-r\fR	Recursive." 5
.IX Item " -r Recursive."
.IP "\fB \-v\fR	Display version information." 5
.IX Item " -v Display version information."
.IP "\fB \-L\fR \fIbundle_lifetime\fR" 5
.IX Item " -L bundle_lifetime"
.PD
Bundle lifetime in seconds. Default is 86400 seconds (1 day).
.IP "\fB \-C\fR \fIBP_custody\fR" 5
.IX Item " -C BP_custody"
Acceptable values are \s-1ON/OFF,YES/NO,1/0.\s0 Default is \s-1ON.\s0
.IP "\fB \-S\fR \fIclass_of_service\fR" 5
.IX Item " -S class_of_service"
Bundle Protocol Class of Service for this transfer. Available options are:
.RS 5
.IP "0	Bulk Priority" 4
.IX Item "0 Bulk Priority"
.PD 0
.IP "1	Standard Priority" 4
.IX Item "1 Standard Priority"
.IP "2	Expedited Priority" 4
.IX Item "2 Expedited Priority"
.RE
.RS 5
.PD
.Sp
Default is Standard Priority.
.RE
.PP
\&\fBbpcp\fR utilizes \s-1CFDP\s0 to preform the actual file transfers. This has several
important implications. First, \s-1ION\s0's \s-1CFDP\s0 implementation requires that reliable
convergence layers be used to transfer the data. Second, file permissions are
not transferred. Files will be made executable on copy. Third, symbolic links
are ignored for local to remote transfers and their target is copied for remote
transfers. Fourth, all hosts must be specified using \s-1ION\s0's \s-1IPN\s0 naming scheme.
.PP
In order to preform remote to local transfers or remote to remote transfers,
\&\fBbpcpd\fR must be running on the remote hosts. However, \fBbpcp\fR should \s-1NOT\s0
be run simultaneously with \fBbpcpd\fR or \fBcfdptest\fR.
.SH "EXIT STATUS"
.IX Header "EXIT STATUS"
.ie n .IP """0""" 4
.el .IP "``0''" 4
.IX Item "0"
\&\fBbpcp\fR terminated normally.
.ie n .IP """1""" 4
.el .IP "``1''" 4
.IX Item "1"
\&\fBbpcp\fR terminated abnormally. Check console and the \fBion.log\fR file for error messages.
.SH "FILES"
.IX Header "FILES"
No configuration files are needed.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
No environment variables apply.
.SH "BUGS"
.IX Header "BUGS"
Report bugs to <ion\-bugs@korgano.eecs.ohiou.edu>
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIbpcpd\fR\|(1), \fIion\fR\|(3), \fIcfdptest\fR\|(1)