| ctm_rmail.1 (81588) | ctm_rmail.1 (95127) |
|---|---|
| 1.\" NOTICE: This is free documentation. I hope you get some use from these 2.\" words. In return you should think about all the nice people who sweat 3.\" blood to document their free software. Maybe you should write some 4.\" documentation and give it away. Maybe with a free program attached! 5.\" 6.\" Author: Stephen McKay 7.\" | 1.\" NOTICE: This is free documentation. I hope you get some use from these 2.\" words. In return you should think about all the nice people who sweat 3.\" blood to document their free software. Maybe you should write some 4.\" documentation and give it away. Maybe with a free program attached! 5.\" 6.\" Author: Stephen McKay 7.\" |
| 8.\" $FreeBSD: head/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 81588 2001-08-13 16:33:00Z ru $ | 8.\" $FreeBSD: head/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 95127 2002-04-20 12:27:18Z charnier $ |
| 9.\" 10.Dd January 24, 1995 11.Dt CTM_MAIL 1 12.Os 13.Sh NAME 14.Nm ctm_smail , 15.Nm ctm_dequeue , 16.Nm ctm_rmail --- 23 unchanged lines hidden (view full) --- 40In conjunction with the 41.Xr ctm 1 42command, 43.Nm ctm_smail , 44.Nm ctm_dequeue 45and 46.Nm ctm_rmail 47are used to distribute changes to a source tree via email. | 9.\" 10.Dd January 24, 1995 11.Dt CTM_MAIL 1 12.Os 13.Sh NAME 14.Nm ctm_smail , 15.Nm ctm_dequeue , 16.Nm ctm_rmail --- 23 unchanged lines hidden (view full) --- 40In conjunction with the 41.Xr ctm 1 42command, 43.Nm ctm_smail , 44.Nm ctm_dequeue 45and 46.Nm ctm_rmail 47are used to distribute changes to a source tree via email. |
| 48The |
|
| 48.Nm ctm_smail | 49.Nm ctm_smail |
| 49is given a compressed | 50utility is given a compressed |
| 50.Xr ctm 51delta, and a mailing list to send it to. It splits the delta into manageable 52pieces, encodes them as mail messages and sends them to the mailing list 53(optionally queued to spread the mail load). 54Each recipient uses 55.Nm ctm_rmail 56(either manually or automatically) to decode and reassemble the delta, and 57optionally call --- 299 unchanged lines hidden (view full) --- 357and drop any failures into your regular mail box. 358Note the 359.Ev PATH 360manipulation in 361.Pa ctm_incoming 362which allows 363.Nm ctm_rmail 364to execute | 51.Xr ctm 52delta, and a mailing list to send it to. It splits the delta into manageable 53pieces, encodes them as mail messages and sends them to the mailing list 54(optionally queued to spread the mail load). 55Each recipient uses 56.Nm ctm_rmail 57(either manually or automatically) to decode and reassemble the delta, and 58optionally call --- 299 unchanged lines hidden (view full) --- 358and drop any failures into your regular mail box. 359Note the 360.Ev PATH 361manipulation in 362.Pa ctm_incoming 363which allows 364.Nm ctm_rmail 365to execute |
| 365.Xr ctm | 366.Xr ctm 1 |
| 366on the 367.Pq non- Ns Fx 368machine that this example was taken from. 369.Sh SECURITY 370On its own, CTM is an insecure protocol 371- there is no authentication performed that the 372changes applied to the source code were sent by a 373trusted party, and so care should be taken if the --- 39 unchanged lines hidden (view full) --- 413Pieces of deltas waiting for the rest to arrive. 414.It Pa DELTADIR/* 415Completed deltas. 416.It Pa BASEDIR/.ctm_status 417File containing the name and number of the next delta to be applied to this 418source tree. 419.El 420.Sh DIAGNOSTICS | 367on the 368.Pq non- Ns Fx 369machine that this example was taken from. 370.Sh SECURITY 371On its own, CTM is an insecure protocol 372- there is no authentication performed that the 373changes applied to the source code were sent by a 374trusted party, and so care should be taken if the --- 39 unchanged lines hidden (view full) --- 414Pieces of deltas waiting for the rest to arrive. 415.It Pa DELTADIR/* 416Completed deltas. 417.It Pa BASEDIR/.ctm_status 418File containing the name and number of the next delta to be applied to this 419source tree. 420.El 421.Sh DIAGNOSTICS |
| 422The |
|
| 421.Nm ctm_smail , 422.Nm ctm_dequeue 423and 424.Nm ctm_rmail | 423.Nm ctm_smail , 424.Nm ctm_dequeue 425and 426.Nm ctm_rmail |
| 425return exit status 0 for success, and 1 for various failures. | 427utilities return exit status 0 for success, and 1 for various failures. 428The |
| 426.Nm ctm_rmail | 429.Nm ctm_rmail |
| 427is expected to be called from a mail transfer program, and thus signals | 430utility is expected to be called from a mail transfer program, and thus signals |
| 428failure only when the input mail message should be bounced (preferably into 429your regular maildrop, not back to the sender). In short, failure to 430apply a completed delta with 431.Xr ctm 432is not considered an error important enough to bounce the mail, and 433.Nm ctm_rmail 434returns an exit status of 0. 435.Pp --- 4 unchanged lines hidden (view full) --- 440ctm_smail: src-cur.0250.gz 1/2 sent to src-guys 441.Ed 442.Pp 443or, if queueing, 444.Bd -literal -offset indent 445ctm_smail: src-cur.0250.gz 1/2 queued for src-guys 446.Ed 447.Pp | 431failure only when the input mail message should be bounced (preferably into 432your regular maildrop, not back to the sender). In short, failure to 433apply a completed delta with 434.Xr ctm 435is not considered an error important enough to bounce the mail, and 436.Nm ctm_rmail 437returns an exit status of 0. 438.Pp --- 4 unchanged lines hidden (view full) --- 443ctm_smail: src-cur.0250.gz 1/2 sent to src-guys 444.Ed 445.Pp 446or, if queueing, 447.Bd -literal -offset indent 448ctm_smail: src-cur.0250.gz 1/2 queued for src-guys 449.Ed 450.Pp |
| 451The |
|
| 448.Nm ctm_dequeue | 452.Nm ctm_dequeue |
| 449will report messages like: | 453utility will report messages like: |
| 450.Bd -literal -offset indent 451ctm_dequeue: src-cur.0250.gz 1/2 sent 452.Ed 453.Pp | 454.Bd -literal -offset indent 455ctm_dequeue: src-cur.0250.gz 1/2 sent 456.Ed 457.Pp |
| 458The |
|
| 454.Nm ctm_rmail | 459.Nm ctm_rmail |
| 455will report messages like: | 460utility will report messages like: |
| 456.Bd -literal -offset indent 457ctm_rmail: src-cur.0250.gz 1/2 stored 458ctm_rmail: src-cur.0250.gz 2/2 stored 459ctm_rmail: src-cur.0250.gz complete 460.Ed 461.Pp 462If any of the input files do not contain a valid delta piece, 463.Nm ctm_rmail 464will report: 465.Bd -literal -offset indent 466ctm_rmail: message contains no delta 467.Ed 468.Pp 469and return an exit status of 1. You can use this to redirect wayward messages 470back into your real mailbox if your mail filter goes wonky. 471.Pp 472These messages go to 473.Em stderr 474or to the log file. Messages from | 461.Bd -literal -offset indent 462ctm_rmail: src-cur.0250.gz 1/2 stored 463ctm_rmail: src-cur.0250.gz 2/2 stored 464ctm_rmail: src-cur.0250.gz complete 465.Ed 466.Pp 467If any of the input files do not contain a valid delta piece, 468.Nm ctm_rmail 469will report: 470.Bd -literal -offset indent 471ctm_rmail: message contains no delta 472.Ed 473.Pp 474and return an exit status of 1. You can use this to redirect wayward messages 475back into your real mailbox if your mail filter goes wonky. 476.Pp 477These messages go to 478.Em stderr 479or to the log file. Messages from |
| 475.Xr ctm | 480.Xr ctm 1 |
| 476turn up here too. Error messages should be self explanatory. 477.Sh SEE ALSO 478.Xr ctm 1 , 479.Xr ctm 5 480.\" .Sh HISTORY 481.Sh AUTHORS 482.An Stephen McKay Aq mckay@FreeBSD.org | 481turn up here too. Error messages should be self explanatory. 482.Sh SEE ALSO 483.Xr ctm 1 , 484.Xr ctm 5 485.\" .Sh HISTORY 486.Sh AUTHORS 487.An Stephen McKay Aq mckay@FreeBSD.org |