~ubuntu-branches/ubuntu/vivid/sup/vivid

« back to all changes in this revision

Viewing changes to supservers.8

• browse files at revision 4
• compare with another revision
• download diff
• download tarball
• view history from revision 4

Show diffs side-by-side

added

removed

supservers.8

 

1

.\"     $NetBSD: supservers.8,v 1.9 2002/02/08 01:38:56 ross Exp $

 

2

.\"

1

3

.\" Copyright (c) 1992 Carnegie Mellon University

2

4

.\" All Rights Reserved.

3

5

.\"

6

8

.\" notice and this permission notice appear in all copies of the

7

9

.\" software, derivative works or modified versions, and any portions

8

10

.\" thereof, and that both notices appear in supporting documentation.

9

 

.\" 

 

11

.\"

10

12

.\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"

11

13

.\" CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR

12

14

.\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.

13

15

.\"

14

16

.\" Carnegie Mellon requests users of this software to return to

15

17

.\"

16

 

.\"  Software Distribution Coordinator  or  Software_Distribution@CS.CMU.EDU

 

18

.\"  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU

17

19

.\"  School of Computer Science

18

20

.\"  Carnegie Mellon University

19

21

.\"  Pittsburgh PA 15213-3890

22

24

.\" the rights to redistribute these changes.

23

25

.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

24

26

.\" HISTORY

25

 

.\" $Log: supservers.8,v $

26

 

.\" Revision 1.1.1.1  1993/08/21  00:46:35  jkh

27

 

.\" Current sup with compression support.

28

 

.\"

29

 

.\" Revision 1.1.1.1  1993/05/21  14:52:16  cgd

30

 

.\" initial import of CMU's SUP to NetBSD

31

 

.\"

32

27

.\" Revision 1.3  92/08/11  12:08:50  mrt

33

28

.\"     Documented -C switch

34

29

.\"     [92/08/11            mrt]

35

 

.\" 

 

30

.\"

36

31

.TH SUPSERVERS 8 1/16/86

37

32

.CM 1

38

33

.SH "NAME"

40

35

.SH "SYNOPSIS"

41

36

supfilesrv

42

37

[

43

 

.I 

 

38

.I

 

39

-4

 

40

] [

 

41

.I

 

42

-6

 

43

] [

 

44

.I

 

45

-d

 

46

] [

 

47

.I

44

48

-l

45

49

] [

46

 

.I 

 

50

.I

47

51

-q

48

52

] [

49

 

.I 

 

53

.I

50

54

-N

51

55

] [

52

 

.I 

 

56

.I

53

57

-P

54

58

] [

55

59

.I -C MaxChildren

56

 

] [

57

 

.I -6

58

 

] [

59

 

.I -4

60

60

]

61

61

.br

62

62

supscan [

63

 

.I 

 

63

.I

64

64

-v

65

65

] [

66

 

.I 

 

66

.I

67

67

-s

68

68

] [

69

 

.I 

 

69

.I

70

70

collection

71

71

] [

72

 

.I 

 

72

.I

73

73

basedir

74

74

]

75

75

.SH "DESCRIPTION"

76

 

.I 

 

76

.I

77

77

Supfilesrv

78

78

is the server processes used to interact with

79

 

.I 

 

79

.I

80

80

sup

81

81

client processes via the IP/TCP network protocol.

82

82

This server

83

83

normally is expected to be running on server machines at all times.

84

84

Each machine with files of interest to users on other machines is

85

85

expected to be a file server and should run

86

 

.I 

 

86

.I

87

87

supfilesrv.

88

 

 

 

88

 

89

89

A file server machine will service requests for both "private" and

90

90

"system" file collections.

91

91

No special action is necessary to support

104

104

 

105

105

Details of setting up a file collection for the file server are

106

106

described in the manual entry for

107

 

.I 

 

107

.I

108

108

sup(1).

109

109

 

110

 

.I 

 

110

.I

111

111

Supfilesrv

112

112

generally runs as a network server process that listens for connections,

113

113

and for each connection (double-)forks a process to handle the interaction

114

114

with the client.

115

 

However, with the -l flag, no forking will take place:

 

115

However, with the -d flag, no forking will take place:

116

116

the server will listen for a network connection, handle it, and exit.

117

117

This is useful for debugging the servers in "live" mode rather than as

118

118

daemons.

124

124

to produce voluminous messages describing the network communication

125

125

progress and status. The more -N switches that you use the more output

126

126

you get. Use 3 (separated by spaces: -N -N -N) to get a complete record

127

 

of all network messages. Log messages are printed by 

 

127

of all network messages. Log messages are printed by

128

128

.I syslog

129

 

on 

 

129

on

130

130

.I daemon.log .

131

131

To suppress

132

132

log messages, the -q "quiet" flag can be used.

133

133

 

 

134

.I supfilesrv

 

135

uses libwrap style access control (the /etc/hosts.allow and /etc/hosts.deny

 

136

files) with service name "supfilesrv". The -l "log" flag turn on loggin of

 

137

accepted connections (denied connections are always logged).

134

138

 

135

 

Normally the 

 

139

Normally the

136

140

.I supfilesrv

137

141

will only respond to 3 requests simultaneously, forking a child

138

142

process for each client. If it gets additional requests it will respond

140

144

to increase (or decrease) this number.

141

145

 

142

146

.I supfilesrv

143

 

is able to communicate over IPv6. Use the -6 command line switch to make

144

 

.I supfilesrv

145

 

listen on IPv6 instead of IPv4.

 

147

listens to IPv4 listening socket by default.

 

148

With the -6 flag, it will listen to IPv6 listening socket.

 

149

For dual stack support you will want to run two instances of

 

150

.I supfilesrv.

146

151

 

147

152

.SH "SUPSCAN"

148

153

It is possible to pre-compile a list of the files in a collection

149

154

to make

150

 

.I 

 

155

.I

151

156

supfilesrv

152

157

service that collection much faster.  This can be done by running

153

 

.I 

 

158

.I

154

159

supscan

155

160

on the desired collection on the repository machine.  This produces a

156

161

list of all the files in the collection at the time of the

157

 

.I 

 

162

.I

158

163

supscan;

159

164

subsequent upgrades will be based on this list of files rather than

160

165

actually scanning the disk at the time of the upgrade.  Of course,

161

166

the upgrade will consequently bring the client machine up to the status

162

167

of the repository machine as of the time of the

163

 

.I 

 

168

.I

164

169

supscan

165

170

rather than as of the time of the upgrade; hence, if

166

 

.I 

 

171

.I

167

172

supscan

168

173

is used, it should be run periodically on the

169

174

collection.

170

175

This facility is useful for extremely large file collections

171

176

that are upgraded many times per day, such as the CMU UNIX system

172

177

software.  The "verbose" flag

173

 

.I 

 

178

.I

174

179

-v

175

180

will cause

176

 

.I 

 

181

.I

177

182

supscan

178

183

to produce output messages as it scans the files in the collection.

179

184

The "system" flag

180

 

.I 

 

185

.I

181

186

-s

182

187

will cause

183

 

.I 

 

188

.I

184

189

supscan

185

190

to scan all system collections residing on the current host.

186

191

The

187

 

.I 

 

192

.I

188

193

basedir

189

194

parameter must be specified if the collection is a private

190

195

collection whose base directory is not the default.

193

198

/usr

194

199

default base directory for a collection

195

200

.TP

196

 

/usr/cs/lib/supfiles/coll.dir

197

 

directory list file for file server

198

 

.TP

199

 

/usr/cs/lib/supfiles/coll.host

200

 

host list file for system sups.

201

 

.TP

202

 

<base-directory>/sup/<collection>/*

 

201

/etc/supfiles/coll.dir

 

202

base directory list for system collections

 

203

.TP

 

204

/etc/supfiles/coll.host

 

205

host name list for system collections

 

206

.TP

 

207

\*[Lt]base-directory\*[Gt]/sup/\*[Lt]collection\*[Gt]/*

203

208

files used by file server (see

204

 

.I 

 

209

.I

205

210

sup(1))

206

211

.TP

207

 

<base-directory>/sup/<collection>/list

 

212

\*[Lt]base-directory\*[Gt]/sup/\*[Lt]collection\*[Gt]/list

208

213

list file used by

209

 

.I 

 

214

.I

210

215

supscan

211

216

to create file list

212

217

.TP

213

 

<base-directory>/sup/<collection>/scan

 

218

\*[Lt]base-directory\*[Gt]/sup/\*[Lt]collection\*[Gt]/scan

214

219

file list created by

215

 

.I 

 

220

.I

216

221

supscan

217

222

from list file

218

223

.i0

220

225

.PP

221

226

.SH "SEE ALSO"

222

227

sup(1)

 

228

hosts_access(5)

 

229

hosts_options(5)

223

230

.br

224

 

.I 

 

231

.I

225

232

The SUP Software Upgrade Protocol,

226

233

S.

227

234

A.

233

240

id number generally accompany each message for diagnostic purposes.

234

241

.SH "HISTORY"

235

242

.TP

236

 

30-Dec-03 Jochen Friedrich at Debian

237

 

Added documentation of IPv6 options.

238

 

.TP

239

243

31-July-92 Mary Thompson (mrt) at Carnegie Mellon University

240

244

Removed references to supnameserver which has not existed for

241

245

a long time. Update a few file names. Added -C switch.

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1