git.r.bdr.sh - rbdr/mobius/blob - hotline/server.go

   1 package hotline
   2
   3 import (
   4         "bufio"
   5         "bytes"
   6         "context"
   7         "encoding/binary"
   8         "errors"
   9         "fmt"
  10         "github.com/go-playground/validator/v10"
  11         "go.uber.org/zap"
  12         "gopkg.in/yaml.v3"
  13         "io"
  14         "io/fs"
  15         "io/ioutil"
  16         "math/big"
  17         "math/rand"
  18         "net"
  19         "os"
  20         "path/filepath"
  21         "runtime/debug"
  22         "strings"
  23         "sync"
  24         "time"
  25 )
  26
  27 type contextKey string
  28
  29 var contextKeyReq = contextKey("req")
  30
  31 type requestCtx struct {
  32         remoteAddr string
  33         login      string
  34         name       string
  35 }
  36
  37 const (
  38         userIdleSeconds        = 300 // time in seconds before an inactive user is marked idle
  39         idleCheckInterval      = 10  // time in seconds to check for idle users
  40         trackerUpdateFrequency = 300 // time in seconds between tracker re-registration
  41 )
  42
  43 var nostalgiaVersion = []byte{0, 0, 2, 0x2c} // version ID used by the Nostalgia client
  44
  45 type Server struct {
  46         Port         int
  47         Accounts     map[string]*Account
  48         Agreement    []byte
  49         Clients      map[uint16]*ClientConn
  50         ThreadedNews *ThreadedNews
  51
  52         fileTransfers map[[4]byte]*FileTransfer
  53
  54         Config        *Config
  55         ConfigDir     string
  56         Logger        *zap.SugaredLogger
  57         PrivateChats  map[uint32]*PrivateChat
  58         NextGuestID   *uint16
  59         TrackerPassID [4]byte
  60         Stats         *Stats
  61
  62         FS FileStore // Storage backend to use for File storage
  63
  64         outbox chan Transaction
  65         mux    sync.Mutex
  66
  67         flatNewsMux sync.Mutex
  68         FlatNews    []byte
  69
  70         banListMU sync.Mutex
  71         banList   map[string]*time.Time
  72 }
  73
  74 type PrivateChat struct {
  75         Subject    string
  76         ClientConn map[uint16]*ClientConn
  77 }
  78
  79 func (s *Server) ListenAndServe(ctx context.Context, cancelRoot context.CancelFunc) error {
  80         s.Logger.Infow("Hotline server started",
  81                 "version", VERSION,
  82                 "API port", fmt.Sprintf(":%v", s.Port),
  83                 "Transfer port", fmt.Sprintf(":%v", s.Port+1),
  84         )
  85
  86         var wg sync.WaitGroup
  87
  88         wg.Add(1)
  89         go func() {
  90                 ln, err := net.Listen("tcp", fmt.Sprintf("%s:%v", "", s.Port))
  91                 if err != nil {
  92                         s.Logger.Fatal(err)
  93                 }
  94
  95                 s.Logger.Fatal(s.Serve(ctx, ln))
  96         }()
  97
  98         wg.Add(1)
  99         go func() {
 100                 ln, err := net.Listen("tcp", fmt.Sprintf("%s:%v", "", s.Port+1))
 101                 if err != nil {
 102                         s.Logger.Fatal(err)
 103
 104                 }
 105
 106                 s.Logger.Fatal(s.ServeFileTransfers(ctx, ln))
 107         }()
 108
 109         wg.Wait()
 110
 111         return nil
 112 }
 113
 114 func (s *Server) ServeFileTransfers(ctx context.Context, ln net.Listener) error {
 115         for {
 116                 conn, err := ln.Accept()
 117                 if err != nil {
 118                         return err
 119                 }
 120
 121                 go func() {
 122                         defer func() { _ = conn.Close() }()
 123
 124                         err = s.handleFileTransfer(
 125                                 context.WithValue(ctx, contextKeyReq, requestCtx{
 126                                         remoteAddr: conn.RemoteAddr().String(),
 127                                 }),
 128                                 conn,
 129                         )
 130
 131                         if err != nil {
 132                                 s.Logger.Errorw("file transfer error", "reason", err)
 133                         }
 134                 }()
 135         }
 136 }
 137
 138 func (s *Server) sendTransaction(t Transaction) error {
 139         clientID, err := byteToInt(*t.clientID)
 140         if err != nil {
 141                 return err
 142         }
 143
 144         s.mux.Lock()
 145         client := s.Clients[uint16(clientID)]
 146         if client == nil {
 147                 return fmt.Errorf("invalid client id %v", *t.clientID)
 148         }
 149
 150         s.mux.Unlock()
 151
 152         b, err := t.MarshalBinary()
 153         if err != nil {
 154                 return err
 155         }
 156
 157         if _, err := client.Connection.Write(b); err != nil {
 158                 return err
 159         }
 160
 161         return nil
 162 }
 163
 164 func (s *Server) processOutbox() {
 165         for {
 166                 t := <-s.outbox
 167                 go func() {
 168                         if err := s.sendTransaction(t); err != nil {
 169                                 s.Logger.Errorw("error sending transaction", "err", err)
 170                         }
 171                 }()
 172         }
 173 }
 174
 175 func (s *Server) Serve(ctx context.Context, ln net.Listener) error {
 176         go s.processOutbox()
 177
 178         for {
 179                 conn, err := ln.Accept()
 180                 if err != nil {
 181                         s.Logger.Errorw("error accepting connection", "err", err)
 182                 }
 183                 connCtx := context.WithValue(ctx, contextKeyReq, requestCtx{
 184                         remoteAddr: conn.RemoteAddr().String(),
 185                 })
 186
 187                 go func() {
 188                         s.Logger.Infow("Connection established", "RemoteAddr", conn.RemoteAddr())
 189
 190                         defer conn.Close()
 191                         if err := s.handleNewConnection(connCtx, conn, conn.RemoteAddr().String()); err != nil {
 192                                 if err == io.EOF {
 193                                         s.Logger.Infow("Client disconnected", "RemoteAddr", conn.RemoteAddr())
 194                                 } else {
 195                                         s.Logger.Errorw("error serving request", "RemoteAddr", conn.RemoteAddr(), "err", err)
 196                                 }
 197                         }
 198                 }()
 199         }
 200 }
 201
 202 const (
 203         agreementFile = "Agreement.txt"
 204 )
 205
 206 // NewServer constructs a new Server from a config dir
 207 func NewServer(configDir string, netPort int, logger *zap.SugaredLogger, FS FileStore) (*Server, error) {
 208         server := Server{
 209                 Port:          netPort,
 210                 Accounts:      make(map[string]*Account),
 211                 Config:        new(Config),
 212                 Clients:       make(map[uint16]*ClientConn),
 213                 fileTransfers: make(map[[4]byte]*FileTransfer),
 214                 PrivateChats:  make(map[uint32]*PrivateChat),
 215                 ConfigDir:     configDir,
 216                 Logger:        logger,
 217                 NextGuestID:   new(uint16),
 218                 outbox:        make(chan Transaction),
 219                 Stats:         &Stats{StartTime: time.Now()},
 220                 ThreadedNews:  &ThreadedNews{},
 221                 FS:            FS,
 222                 banList:       make(map[string]*time.Time),
 223         }
 224
 225         var err error
 226
 227         // generate a new random passID for tracker registration
 228         if _, err := rand.Read(server.TrackerPassID[:]); err != nil {
 229                 return nil, err
 230         }
 231
 232         server.Agreement, err = os.ReadFile(filepath.Join(configDir, agreementFile))
 233         if err != nil {
 234                 return nil, err
 235         }
 236
 237         if server.FlatNews, err = os.ReadFile(filepath.Join(configDir, "MessageBoard.txt")); err != nil {
 238                 return nil, err
 239         }
 240
 241         // try to load the ban list, but ignore errors as this file may not be present or may be empty
 242         _ = server.loadBanList(filepath.Join(configDir, "Banlist.yaml"))
 243
 244         if err := server.loadThreadedNews(filepath.Join(configDir, "ThreadedNews.yaml")); err != nil {
 245                 return nil, err
 246         }
 247
 248         if err := server.loadConfig(filepath.Join(configDir, "config.yaml")); err != nil {
 249                 return nil, err
 250         }
 251
 252         if err := server.loadAccounts(filepath.Join(configDir, "Users/")); err != nil {
 253                 return nil, err
 254         }
 255
 256         server.Config.FileRoot = filepath.Join(configDir, "Files")
 257
 258         *server.NextGuestID = 1
 259
 260         if server.Config.EnableTrackerRegistration {
 261                 server.Logger.Infow(
 262                         "Tracker registration enabled",
 263                         "frequency", fmt.Sprintf("%vs", trackerUpdateFrequency),
 264                         "trackers", server.Config.Trackers,
 265                 )
 266
 267                 go func() {
 268                         for {
 269                                 tr := &TrackerRegistration{
 270                                         UserCount:   server.userCount(),
 271                                         PassID:      server.TrackerPassID[:],
 272                                         Name:        server.Config.Name,
 273                                         Description: server.Config.Description,
 274                                 }
 275                                 binary.BigEndian.PutUint16(tr.Port[:], uint16(server.Port))
 276                                 for _, t := range server.Config.Trackers {
 277                                         if err := register(t, tr); err != nil {
 278                                                 server.Logger.Errorw("unable to register with tracker %v", "error", err)
 279                                         }
 280                                         server.Logger.Infow("Sent Tracker registration", "data", tr)
 281                                 }
 282
 283                                 time.Sleep(trackerUpdateFrequency * time.Second)
 284                         }
 285                 }()
 286         }
 287
 288         // Start Client Keepalive go routine
 289         go server.keepaliveHandler()
 290
 291         return &server, nil
 292 }
 293
 294 func (s *Server) userCount() int {
 295         s.mux.Lock()
 296         defer s.mux.Unlock()
 297
 298         return len(s.Clients)
 299 }
 300
 301 func (s *Server) keepaliveHandler() {
 302         for {
 303                 time.Sleep(idleCheckInterval * time.Second)
 304                 s.mux.Lock()
 305
 306                 for _, c := range s.Clients {
 307                         c.IdleTime += idleCheckInterval
 308                         if c.IdleTime > userIdleSeconds && !c.Idle {
 309                                 c.Idle = true
 310
 311                                 flagBitmap := big.NewInt(int64(binary.BigEndian.Uint16(c.Flags)))
 312                                 flagBitmap.SetBit(flagBitmap, userFlagAway, 1)
 313                                 binary.BigEndian.PutUint16(c.Flags, uint16(flagBitmap.Int64()))
 314
 315                                 c.sendAll(
 316                                         tranNotifyChangeUser,
 317                                         NewField(fieldUserID, *c.ID),
 318                                         NewField(fieldUserFlags, c.Flags),
 319                                         NewField(fieldUserName, c.UserName),
 320                                         NewField(fieldUserIconID, c.Icon),
 321                                 )
 322                         }
 323                 }
 324                 s.mux.Unlock()
 325         }
 326 }
 327
 328 func (s *Server) writeBanList() error {
 329         s.banListMU.Lock()
 330         defer s.banListMU.Unlock()
 331
 332         out, err := yaml.Marshal(s.banList)
 333         if err != nil {
 334                 return err
 335         }
 336         err = ioutil.WriteFile(
 337                 filepath.Join(s.ConfigDir, "Banlist.yaml"),
 338                 out,
 339                 0666,
 340         )
 341         return err
 342 }
 343
 344 func (s *Server) writeThreadedNews() error {
 345         s.mux.Lock()
 346         defer s.mux.Unlock()
 347
 348         out, err := yaml.Marshal(s.ThreadedNews)
 349         if err != nil {
 350                 return err
 351         }
 352         err = ioutil.WriteFile(
 353                 filepath.Join(s.ConfigDir, "ThreadedNews.yaml"),
 354                 out,
 355                 0666,
 356         )
 357         return err
 358 }
 359
 360 func (s *Server) NewClientConn(conn io.ReadWriteCloser, remoteAddr string) *ClientConn {
 361         s.mux.Lock()
 362         defer s.mux.Unlock()
 363
 364         clientConn := &ClientConn{
 365                 ID:         &[]byte{0, 0},
 366                 Icon:       []byte{0, 0},
 367                 Flags:      []byte{0, 0},
 368                 UserName:   []byte{},
 369                 Connection: conn,
 370                 Server:     s,
 371                 Version:    []byte{},
 372                 AutoReply:  []byte{},
 373                 transfers:  map[int]map[[4]byte]*FileTransfer{},
 374                 Agreed:     false,
 375                 RemoteAddr: remoteAddr,
 376         }
 377         clientConn.transfers = map[int]map[[4]byte]*FileTransfer{
 378                 FileDownload:   {},
 379                 FileUpload:     {},
 380                 FolderDownload: {},
 381                 FolderUpload:   {},
 382                 bannerDownload: {},
 383         }
 384
 385         *s.NextGuestID++
 386         ID := *s.NextGuestID
 387
 388         binary.BigEndian.PutUint16(*clientConn.ID, ID)
 389         s.Clients[ID] = clientConn
 390
 391         return clientConn
 392 }
 393
 394 // NewUser creates a new user account entry in the server map and config file
 395 func (s *Server) NewUser(login, name, password string, access []byte) error {
 396         s.mux.Lock()
 397         defer s.mux.Unlock()
 398
 399         account := Account{
 400                 Login:    login,
 401                 Name:     name,
 402                 Password: hashAndSalt([]byte(password)),
 403                 Access:   &access,
 404         }
 405         out, err := yaml.Marshal(&account)
 406         if err != nil {
 407                 return err
 408         }
 409         s.Accounts[login] = &account
 410
 411         return s.FS.WriteFile(filepath.Join(s.ConfigDir, "Users", login+".yaml"), out, 0666)
 412 }
 413
 414 func (s *Server) UpdateUser(login, newLogin, name, password string, access []byte) error {
 415         s.mux.Lock()
 416         defer s.mux.Unlock()
 417
 418         // update renames the user login
 419         if login != newLogin {
 420                 err := os.Rename(filepath.Join(s.ConfigDir, "Users", login+".yaml"), filepath.Join(s.ConfigDir, "Users", newLogin+".yaml"))
 421                 if err != nil {
 422                         return err
 423                 }
 424                 s.Accounts[newLogin] = s.Accounts[login]
 425                 delete(s.Accounts, login)
 426         }
 427
 428         account := s.Accounts[newLogin]
 429         account.Access = &access
 430         account.Name = name
 431         account.Password = password
 432
 433         out, err := yaml.Marshal(&account)
 434         if err != nil {
 435                 return err
 436         }
 437
 438         if err := os.WriteFile(filepath.Join(s.ConfigDir, "Users", newLogin+".yaml"), out, 0666); err != nil {
 439                 return err
 440         }
 441
 442         return nil
 443 }
 444
 445 // DeleteUser deletes the user account
 446 func (s *Server) DeleteUser(login string) error {
 447         s.mux.Lock()
 448         defer s.mux.Unlock()
 449
 450         delete(s.Accounts, login)
 451
 452         return s.FS.Remove(filepath.Join(s.ConfigDir, "Users", login+".yaml"))
 453 }
 454
 455 func (s *Server) connectedUsers() []Field {
 456         s.mux.Lock()
 457         defer s.mux.Unlock()
 458
 459         var connectedUsers []Field
 460         for _, c := range sortedClients(s.Clients) {
 461                 if !c.Agreed {
 462                         continue
 463                 }
 464                 user := User{
 465                         ID:    *c.ID,
 466                         Icon:  c.Icon,
 467                         Flags: c.Flags,
 468                         Name:  string(c.UserName),
 469                 }
 470                 connectedUsers = append(connectedUsers, NewField(fieldUsernameWithInfo, user.Payload()))
 471         }
 472         return connectedUsers
 473 }
 474
 475 func (s *Server) loadBanList(path string) error {
 476         fh, err := os.Open(path)
 477         if err != nil {
 478                 return err
 479         }
 480         decoder := yaml.NewDecoder(fh)
 481
 482         return decoder.Decode(s.banList)
 483 }
 484
 485 // loadThreadedNews loads the threaded news data from disk
 486 func (s *Server) loadThreadedNews(threadedNewsPath string) error {
 487         fh, err := os.Open(threadedNewsPath)
 488         if err != nil {
 489                 return err
 490         }
 491         decoder := yaml.NewDecoder(fh)
 492
 493         return decoder.Decode(s.ThreadedNews)
 494 }
 495
 496 // loadAccounts loads account data from disk
 497 func (s *Server) loadAccounts(userDir string) error {
 498         matches, err := filepath.Glob(filepath.Join(userDir, "*.yaml"))
 499         if err != nil {
 500                 return err
 501         }
 502
 503         if len(matches) == 0 {
 504                 return errors.New("no user accounts found in " + userDir)
 505         }
 506
 507         for _, file := range matches {
 508                 fh, err := s.FS.Open(file)
 509                 if err != nil {
 510                         return err
 511                 }
 512
 513                 account := Account{}
 514                 decoder := yaml.NewDecoder(fh)
 515                 if err := decoder.Decode(&account); err != nil {
 516                         return err
 517                 }
 518
 519                 s.Accounts[account.Login] = &account
 520         }
 521         return nil
 522 }
 523
 524 func (s *Server) loadConfig(path string) error {
 525         fh, err := s.FS.Open(path)
 526         if err != nil {
 527                 return err
 528         }
 529
 530         decoder := yaml.NewDecoder(fh)
 531         err = decoder.Decode(s.Config)
 532         if err != nil {
 533                 return err
 534         }
 535
 536         validate := validator.New()
 537         err = validate.Struct(s.Config)
 538         if err != nil {
 539                 return err
 540         }
 541         return nil
 542 }
 543
 544 // dontPanic logs panics instead of crashing
 545 func dontPanic(logger *zap.SugaredLogger) {
 546         if r := recover(); r != nil {
 547                 fmt.Println("stacktrace from panic: \n" + string(debug.Stack()))
 548                 logger.Errorw("PANIC", "err", r, "trace", string(debug.Stack()))
 549         }
 550 }
 551
 552 // handleNewConnection takes a new net.Conn and performs the initial login sequence
 553 func (s *Server) handleNewConnection(ctx context.Context, rwc io.ReadWriteCloser, remoteAddr string) error {
 554         defer dontPanic(s.Logger)
 555
 556         if err := Handshake(rwc); err != nil {
 557                 return err
 558         }
 559
 560         // Create a new scanner for parsing incoming bytes into transaction tokens
 561         scanner := bufio.NewScanner(rwc)
 562         scanner.Split(transactionScanner)
 563
 564         scanner.Scan()
 565
 566         clientLogin, _, err := ReadTransaction(scanner.Bytes())
 567         if err != nil {
 568                 panic(err)
 569         }
 570
 571         c := s.NewClientConn(rwc, remoteAddr)
 572
 573         // check if remoteAddr is present in the ban list
 574         if banUntil, ok := s.banList[strings.Split(remoteAddr, ":")[0]]; ok {
 575                 // permaban
 576                 if banUntil == nil {
 577                         s.outbox <- *NewTransaction(
 578                                 tranServerMsg,
 579                                 c.ID,
 580                                 NewField(fieldData, []byte("You are permanently banned on this server")),
 581                                 NewField(fieldChatOptions, []byte{0, 0}),
 582                         )
 583                         time.Sleep(1 * time.Second)
 584                         return nil
 585                 } else if time.Now().Before(*banUntil) {
 586                         s.outbox <- *NewTransaction(
 587                                 tranServerMsg,
 588                                 c.ID,
 589                                 NewField(fieldData, []byte("You are temporarily banned on this server")),
 590                                 NewField(fieldChatOptions, []byte{0, 0}),
 591                         )
 592                         time.Sleep(1 * time.Second)
 593                         return nil
 594                 }
 595
 596         }
 597         defer c.Disconnect()
 598
 599         encodedLogin := clientLogin.GetField(fieldUserLogin).Data
 600         encodedPassword := clientLogin.GetField(fieldUserPassword).Data
 601         c.Version = clientLogin.GetField(fieldVersion).Data
 602
 603         var login string
 604         for _, char := range encodedLogin {
 605                 login += string(rune(255 - uint(char)))
 606         }
 607         if login == "" {
 608                 login = GuestAccount
 609         }
 610
 611         c.logger = s.Logger.With("remoteAddr", remoteAddr, "login", login)
 612
 613         // If authentication fails, send error reply and close connection
 614         if !c.Authenticate(login, encodedPassword) {
 615                 t := c.NewErrReply(clientLogin, "Incorrect login.")
 616                 b, err := t.MarshalBinary()
 617                 if err != nil {
 618                         return err
 619                 }
 620                 if _, err := rwc.Write(b); err != nil {
 621                         return err
 622                 }
 623
 624                 c.logger.Infow("Login failed", "clientVersion", fmt.Sprintf("%x", c.Version))
 625
 626                 return nil
 627         }
 628
 629         if clientLogin.GetField(fieldUserIconID).Data != nil {
 630                 c.Icon = clientLogin.GetField(fieldUserIconID).Data
 631         }
 632
 633         c.Account = c.Server.Accounts[login]
 634
 635         if clientLogin.GetField(fieldUserName).Data != nil {
 636                 if c.Authorize(accessAnyName) {
 637                         c.UserName = clientLogin.GetField(fieldUserName).Data
 638                 } else {
 639                         c.UserName = []byte(c.Account.Name)
 640                 }
 641         }
 642
 643         if c.Authorize(accessDisconUser) {
 644                 c.Flags = []byte{0, 2}
 645         }
 646
 647         s.outbox <- c.NewReply(clientLogin,
 648                 NewField(fieldVersion, []byte{0x00, 0xbe}),
 649                 NewField(fieldCommunityBannerID, []byte{0, 0}),
 650                 NewField(fieldServerName, []byte(s.Config.Name)),
 651         )
 652
 653         // Send user access privs so client UI knows how to behave
 654         c.Server.outbox <- *NewTransaction(tranUserAccess, c.ID, NewField(fieldUserAccess, *c.Account.Access))
 655
 656         // Accounts with accessNoAgreement do not receive the server agreement on login.  The behavior is different between
 657         // client versions.  For 1.2.3 client, we do not send tranShowAgreement.  For other client versions, we send
 658         // tranShowAgreement but with the NoServerAgreement field set to 1.
 659         if c.Authorize(accessNoAgreement) {
 660                 // If client version is nil, then the client uses the 1.2.3 login behavior
 661                 if c.Version != nil {
 662                         c.Server.outbox <- *NewTransaction(tranShowAgreement, c.ID, NewField(fieldNoServerAgreement, []byte{1}))
 663                 }
 664         } else {
 665                 c.Server.outbox <- *NewTransaction(tranShowAgreement, c.ID, NewField(fieldData, s.Agreement))
 666         }
 667
 668         // Used simplified hotline v1.2.3 login flow for clients that do not send login info in tranAgreed
 669         if c.Version == nil || bytes.Equal(c.Version, nostalgiaVersion) {
 670                 c.Agreed = true
 671                 c.logger = c.logger.With("name", string(c.UserName))
 672                 c.logger.Infow("Login successful", "clientVersion", fmt.Sprintf("%x", c.Version))
 673
 674                 for _, t := range c.notifyOthers(
 675                         *NewTransaction(
 676                                 tranNotifyChangeUser, nil,
 677                                 NewField(fieldUserName, c.UserName),
 678                                 NewField(fieldUserID, *c.ID),
 679                                 NewField(fieldUserIconID, c.Icon),
 680                                 NewField(fieldUserFlags, c.Flags),
 681                         ),
 682                 ) {
 683                         c.Server.outbox <- t
 684                 }
 685         }
 686
 687         c.Server.Stats.LoginCount += 1
 688
 689         // Scan for new transactions and handle them as they come in.
 690         for scanner.Scan() {
 691                 // Make a new []byte slice and copy the scanner bytes to it.  This is critical to avoid a data race as the
 692                 // scanner re-uses the buffer for subsequent scans.
 693                 buf := make([]byte, len(scanner.Bytes()))
 694                 copy(buf, scanner.Bytes())
 695
 696                 t, _, err := ReadTransaction(buf)
 697                 if err != nil {
 698                         panic(err)
 699                 }
 700                 if err := c.handleTransaction(*t); err != nil {
 701                         c.logger.Errorw("Error handling transaction", "err", err)
 702                 }
 703         }
 704         return nil
 705 }
 706
 707 func (s *Server) NewPrivateChat(cc *ClientConn) []byte {
 708         s.mux.Lock()
 709         defer s.mux.Unlock()
 710
 711         randID := make([]byte, 4)
 712         rand.Read(randID)
 713         data := binary.BigEndian.Uint32(randID[:])
 714
 715         s.PrivateChats[data] = &PrivateChat{
 716                 Subject:    "",
 717                 ClientConn: make(map[uint16]*ClientConn),
 718         }
 719         s.PrivateChats[data].ClientConn[cc.uint16ID()] = cc
 720
 721         return randID
 722 }
 723
 724 const dlFldrActionSendFile = 1
 725 const dlFldrActionResumeFile = 2
 726 const dlFldrActionNextFile = 3
 727
 728 // handleFileTransfer receives a client net.Conn from the file transfer server, performs the requested transfer type, then closes the connection
 729 func (s *Server) handleFileTransfer(ctx context.Context, rwc io.ReadWriter) error {
 730         defer dontPanic(s.Logger)
 731
 732         txBuf := make([]byte, 16)
 733         if _, err := io.ReadFull(rwc, txBuf); err != nil {
 734                 return err
 735         }
 736
 737         var t transfer
 738         if _, err := t.Write(txBuf); err != nil {
 739                 return err
 740         }
 741
 742         defer func() {
 743                 s.mux.Lock()
 744                 delete(s.fileTransfers, t.ReferenceNumber)
 745                 s.mux.Unlock()
 746
 747         }()
 748
 749         s.mux.Lock()
 750         fileTransfer, ok := s.fileTransfers[t.ReferenceNumber]
 751         s.mux.Unlock()
 752         if !ok {
 753                 return errors.New("invalid transaction ID")
 754         }
 755
 756         defer func() {
 757                 fileTransfer.ClientConn.transfersMU.Lock()
 758                 delete(fileTransfer.ClientConn.transfers[fileTransfer.Type], t.ReferenceNumber)
 759                 fileTransfer.ClientConn.transfersMU.Unlock()
 760         }()
 761
 762         rLogger := s.Logger.With(
 763                 "remoteAddr", ctx.Value(contextKeyReq).(requestCtx).remoteAddr,
 764                 "login", fileTransfer.ClientConn.Account.Login,
 765                 "name", string(fileTransfer.ClientConn.UserName),
 766         )
 767
 768         fullPath, err := readPath(s.Config.FileRoot, fileTransfer.FilePath, fileTransfer.FileName)
 769         if err != nil {
 770                 return err
 771         }
 772
 773         switch fileTransfer.Type {
 774         case bannerDownload:
 775                 if err := s.bannerDownload(rwc); err != nil {
 776                         panic(err)
 777                         return err
 778                 }
 779         case FileDownload:
 780                 s.Stats.DownloadCounter += 1
 781
 782                 var dataOffset int64
 783                 if fileTransfer.fileResumeData != nil {
 784                         dataOffset = int64(binary.BigEndian.Uint32(fileTransfer.fileResumeData.ForkInfoList[0].DataSize[:]))
 785                 }
 786
 787                 fw, err := newFileWrapper(s.FS, fullPath, 0)
 788                 if err != nil {
 789                         return err
 790                 }
 791
 792                 rLogger.Infow("File download started", "filePath", fullPath)
 793
 794                 // if file transfer options are included, that means this is a "quick preview" request from a 1.5+ client
 795                 if fileTransfer.options == nil {
 796                         // Start by sending flat file object to client
 797                         if _, err := rwc.Write(fw.ffo.BinaryMarshal()); err != nil {
 798                                 return err
 799                         }
 800                 }
 801
 802                 file, err := fw.dataForkReader()
 803                 if err != nil {
 804                         return err
 805                 }
 806
 807                 br := bufio.NewReader(file)
 808                 if _, err := br.Discard(int(dataOffset)); err != nil {
 809                         return err
 810                 }
 811
 812                 if _, err = io.Copy(rwc, io.TeeReader(br, fileTransfer.bytesSentCounter)); err != nil {
 813                         return err
 814                 }
 815
 816                 // if the client requested to resume transfer, do not send the resource fork header, or it will be appended into the fileWrapper data
 817                 if fileTransfer.fileResumeData == nil {
 818                         err = binary.Write(rwc, binary.BigEndian, fw.rsrcForkHeader())
 819                         if err != nil {
 820                                 return err
 821                         }
 822                 }
 823
 824                 rFile, err := fw.rsrcForkFile()
 825                 if err != nil {
 826                         return nil
 827                 }
 828
 829                 if _, err = io.Copy(rwc, io.TeeReader(rFile, fileTransfer.bytesSentCounter)); err != nil {
 830                         return err
 831                 }
 832
 833         case FileUpload:
 834                 s.Stats.UploadCounter += 1
 835
 836                 var file *os.File
 837
 838                 // A file upload has three possible cases:
 839                 // 1) Upload a new file
 840                 // 2) Resume a partially transferred file
 841                 // 3) Replace a fully uploaded file
 842                 //  We have to infer which case applies by inspecting what is already on the filesystem
 843
 844                 // 1) Check for existing file:
 845                 _, err = os.Stat(fullPath)
 846                 if err == nil {
 847                         return errors.New("existing file found at " + fullPath)
 848                 }
 849                 if errors.Is(err, fs.ErrNotExist) {
 850                         // If not found, open or create a new .incomplete file
 851                         file, err = os.OpenFile(fullPath+incompleteFileSuffix, os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0644)
 852                         if err != nil {
 853                                 return err
 854                         }
 855                 }
 856
 857                 f, err := newFileWrapper(s.FS, fullPath, 0)
 858                 if err != nil {
 859                         return err
 860                 }
 861
 862                 rLogger.Infow("File upload started", "dstFile", fullPath)
 863
 864                 rForkWriter := io.Discard
 865                 iForkWriter := io.Discard
 866                 if s.Config.PreserveResourceForks {
 867                         rForkWriter, err = f.rsrcForkWriter()
 868                         if err != nil {
 869                                 return err
 870                         }
 871
 872                         iForkWriter, err = f.infoForkWriter()
 873                         if err != nil {
 874                                 return err
 875                         }
 876                 }
 877
 878                 if err := receiveFile(rwc, file, rForkWriter, iForkWriter, fileTransfer.bytesSentCounter); err != nil {
 879                         s.Logger.Error(err)
 880                 }
 881
 882                 if err := file.Close(); err != nil {
 883                         return err
 884                 }
 885
 886                 if err := s.FS.Rename(fullPath+".incomplete", fullPath); err != nil {
 887                         return err
 888                 }
 889
 890                 rLogger.Infow("File upload complete", "dstFile", fullPath)
 891         case FolderDownload:
 892                 // Folder Download flow:
 893                 // 1. Get filePath from the transfer
 894                 // 2. Iterate over files
 895                 // 3. For each fileWrapper:
 896                 //       Send fileWrapper header to client
 897                 // The client can reply in 3 ways:
 898                 //
 899                 // 1. If type is an odd number (unknown type?), or fileWrapper download for the current fileWrapper is completed:
 900                 //              client sends []byte{0x00, 0x03} to tell the server to continue to the next fileWrapper
 901                 //
 902                 // 2. If download of a fileWrapper is to be resumed:
 903                 //              client sends:
 904                 //                      []byte{0x00, 0x02} // download folder action
 905                 //                      [2]byte // Resume data size
 906                 //                      []byte fileWrapper resume data (see myField_FileResumeData)
 907                 //
 908                 // 3. Otherwise, download of the fileWrapper is requested and client sends []byte{0x00, 0x01}
 909                 //
 910                 // When download is requested (case 2 or 3), server replies with:
 911                 //                      [4]byte - fileWrapper size
 912                 //                      []byte  - Flattened File Object
 913                 //
 914                 // After every fileWrapper download, client could request next fileWrapper with:
 915                 //                      []byte{0x00, 0x03}
 916                 //
 917                 // This notifies the server to send the next item header
 918
 919                 basePathLen := len(fullPath)
 920
 921                 rLogger.Infow("Start folder download", "path", fullPath)
 922
 923                 nextAction := make([]byte, 2)
 924                 if _, err := io.ReadFull(rwc, nextAction); err != nil {
 925                         return err
 926                 }
 927
 928                 i := 0
 929                 err = filepath.Walk(fullPath+"/", func(path string, info os.FileInfo, err error) error {
 930                         s.Stats.DownloadCounter += 1
 931                         i += 1
 932
 933                         if err != nil {
 934                                 return err
 935                         }
 936
 937                         // skip dot files
 938                         if strings.HasPrefix(info.Name(), ".") {
 939                                 return nil
 940                         }
 941
 942                         hlFile, err := newFileWrapper(s.FS, path, 0)
 943                         if err != nil {
 944                                 return err
 945                         }
 946
 947                         subPath := path[basePathLen+1:]
 948                         rLogger.Debugw("Sending fileheader", "i", i, "path", path, "fullFilePath", fullPath, "subPath", subPath, "IsDir", info.IsDir())
 949
 950                         if i == 1 {
 951                                 return nil
 952                         }
 953
 954                         fileHeader := NewFileHeader(subPath, info.IsDir())
 955
 956                         // Send the fileWrapper header to client
 957                         if _, err := rwc.Write(fileHeader.Payload()); err != nil {
 958                                 s.Logger.Errorf("error sending file header: %v", err)
 959                                 return err
 960                         }
 961
 962                         // Read the client's Next Action request
 963                         if _, err := io.ReadFull(rwc, nextAction); err != nil {
 964                                 return err
 965                         }
 966
 967                         rLogger.Debugw("Client folder download action", "action", fmt.Sprintf("%X", nextAction[0:2]))
 968
 969                         var dataOffset int64
 970
 971                         switch nextAction[1] {
 972                         case dlFldrActionResumeFile:
 973                                 // get size of resumeData
 974                                 resumeDataByteLen := make([]byte, 2)
 975                                 if _, err := io.ReadFull(rwc, resumeDataByteLen); err != nil {
 976                                         return err
 977                                 }
 978
 979                                 resumeDataLen := binary.BigEndian.Uint16(resumeDataByteLen)
 980                                 resumeDataBytes := make([]byte, resumeDataLen)
 981                                 if _, err := io.ReadFull(rwc, resumeDataBytes); err != nil {
 982                                         return err
 983                                 }
 984
 985                                 var frd FileResumeData
 986                                 if err := frd.UnmarshalBinary(resumeDataBytes); err != nil {
 987                                         return err
 988                                 }
 989                                 dataOffset = int64(binary.BigEndian.Uint32(frd.ForkInfoList[0].DataSize[:]))
 990                         case dlFldrActionNextFile:
 991                                 // client asked to skip this file
 992                                 return nil
 993                         }
 994
 995                         if info.IsDir() {
 996                                 return nil
 997                         }
 998
 999                         rLogger.Infow("File download started",
1000                                 "fileName", info.Name(),
1001                                 "TransferSize", fmt.Sprintf("%x", hlFile.ffo.TransferSize(dataOffset)),
1002                         )
1003
1004                         // Send file size to client
1005                         if _, err := rwc.Write(hlFile.ffo.TransferSize(dataOffset)); err != nil {
1006                                 s.Logger.Error(err)
1007                                 return err
1008                         }
1009
1010                         // Send ffo bytes to client
1011                         if _, err := rwc.Write(hlFile.ffo.BinaryMarshal()); err != nil {
1012                                 s.Logger.Error(err)
1013                                 return err
1014                         }
1015
1016                         file, err := s.FS.Open(path)
1017                         if err != nil {
1018                                 return err
1019                         }
1020
1021                         // wr := bufio.NewWriterSize(rwc, 1460)
1022                         if _, err = io.Copy(rwc, io.TeeReader(file, fileTransfer.bytesSentCounter)); err != nil {
1023                                 return err
1024                         }
1025
1026                         if nextAction[1] != 2 && hlFile.ffo.FlatFileHeader.ForkCount[1] == 3 {
1027                                 err = binary.Write(rwc, binary.BigEndian, hlFile.rsrcForkHeader())
1028                                 if err != nil {
1029                                         return err
1030                                 }
1031
1032                                 rFile, err := hlFile.rsrcForkFile()
1033                                 if err != nil {
1034                                         return err
1035                                 }
1036
1037                                 if _, err = io.Copy(rwc, io.TeeReader(rFile, fileTransfer.bytesSentCounter)); err != nil {
1038                                         return err
1039                                 }
1040                         }
1041
1042                         // Read the client's Next Action request.  This is always 3, I think?
1043                         if _, err := io.ReadFull(rwc, nextAction); err != nil {
1044                                 return err
1045                         }
1046
1047                         return nil
1048                 })
1049
1050                 if err != nil {
1051                         return err
1052                 }
1053
1054         case FolderUpload:
1055                 rLogger.Infow(
1056                         "Folder upload started",
1057                         "dstPath", fullPath,
1058                         "TransferSize", binary.BigEndian.Uint32(fileTransfer.TransferSize),
1059                         "FolderItemCount", fileTransfer.FolderItemCount,
1060                 )
1061
1062                 // Check if the target folder exists.  If not, create it.
1063                 if _, err := s.FS.Stat(fullPath); os.IsNotExist(err) {
1064                         if err := s.FS.Mkdir(fullPath, 0777); err != nil {
1065                                 return err
1066                         }
1067                 }
1068
1069                 // Begin the folder upload flow by sending the "next file action" to client
1070                 if _, err := rwc.Write([]byte{0, dlFldrActionNextFile}); err != nil {
1071                         return err
1072                 }
1073
1074                 fileSize := make([]byte, 4)
1075
1076                 for i := 0; i < fileTransfer.ItemCount(); i++ {
1077                         s.Stats.UploadCounter += 1
1078
1079                         var fu folderUpload
1080                         if _, err := io.ReadFull(rwc, fu.DataSize[:]); err != nil {
1081                                 return err
1082                         }
1083                         if _, err := io.ReadFull(rwc, fu.IsFolder[:]); err != nil {
1084                                 return err
1085                         }
1086                         if _, err := io.ReadFull(rwc, fu.PathItemCount[:]); err != nil {
1087                                 return err
1088                         }
1089
1090                         fu.FileNamePath = make([]byte, binary.BigEndian.Uint16(fu.DataSize[:])-4) // -4 to subtract the path separator bytes
1091
1092                         if _, err := io.ReadFull(rwc, fu.FileNamePath); err != nil {
1093                                 return err
1094                         }
1095
1096                         rLogger.Infow(
1097                                 "Folder upload continued",
1098                                 "FormattedPath", fu.FormattedPath(),
1099                                 "IsFolder", fmt.Sprintf("%x", fu.IsFolder),
1100                                 "PathItemCount", binary.BigEndian.Uint16(fu.PathItemCount[:]),
1101                         )
1102
1103                         if fu.IsFolder == [2]byte{0, 1} {
1104                                 if _, err := os.Stat(filepath.Join(fullPath, fu.FormattedPath())); os.IsNotExist(err) {
1105                                         if err := os.Mkdir(filepath.Join(fullPath, fu.FormattedPath()), 0777); err != nil {
1106                                                 return err
1107                                         }
1108                                 }
1109
1110                                 // Tell client to send next file
1111                                 if _, err := rwc.Write([]byte{0, dlFldrActionNextFile}); err != nil {
1112                                         return err
1113                                 }
1114                         } else {
1115                                 nextAction := dlFldrActionSendFile
1116
1117                                 // Check if we have the full file already.  If so, send dlFldrAction_NextFile to client to skip.
1118                                 _, err = os.Stat(filepath.Join(fullPath, fu.FormattedPath()))
1119                                 if err != nil && !errors.Is(err, fs.ErrNotExist) {
1120                                         return err
1121                                 }
1122                                 if err == nil {
1123                                         nextAction = dlFldrActionNextFile
1124                                 }
1125
1126                                 //  Check if we have a partial file already.  If so, send dlFldrAction_ResumeFile to client to resume upload.
1127                                 incompleteFile, err := os.Stat(filepath.Join(fullPath, fu.FormattedPath()+incompleteFileSuffix))
1128                                 if err != nil && !errors.Is(err, fs.ErrNotExist) {
1129                                         return err
1130                                 }
1131                                 if err == nil {
1132                                         nextAction = dlFldrActionResumeFile
1133                                 }
1134
1135                                 if _, err := rwc.Write([]byte{0, uint8(nextAction)}); err != nil {
1136                                         return err
1137                                 }
1138
1139                                 switch nextAction {
1140                                 case dlFldrActionNextFile:
1141                                         continue
1142                                 case dlFldrActionResumeFile:
1143                                         offset := make([]byte, 4)
1144                                         binary.BigEndian.PutUint32(offset, uint32(incompleteFile.Size()))
1145
1146                                         file, err := os.OpenFile(fullPath+"/"+fu.FormattedPath()+incompleteFileSuffix, os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
1147                                         if err != nil {
1148                                                 return err
1149                                         }
1150
1151                                         fileResumeData := NewFileResumeData([]ForkInfoList{*NewForkInfoList(offset)})
1152
1153                                         b, _ := fileResumeData.BinaryMarshal()
1154
1155                                         bs := make([]byte, 2)
1156                                         binary.BigEndian.PutUint16(bs, uint16(len(b)))
1157
1158                                         if _, err := rwc.Write(append(bs, b...)); err != nil {
1159                                                 return err
1160                                         }
1161
1162                                         if _, err := io.ReadFull(rwc, fileSize); err != nil {
1163                                                 return err
1164                                         }
1165
1166                                         if err := receiveFile(rwc, file, ioutil.Discard, ioutil.Discard, fileTransfer.bytesSentCounter); err != nil {
1167                                                 s.Logger.Error(err)
1168                                         }
1169
1170                                         err = os.Rename(fullPath+"/"+fu.FormattedPath()+".incomplete", fullPath+"/"+fu.FormattedPath())
1171                                         if err != nil {
1172                                                 return err
1173                                         }
1174
1175                                 case dlFldrActionSendFile:
1176                                         if _, err := io.ReadFull(rwc, fileSize); err != nil {
1177                                                 return err
1178                                         }
1179
1180                                         filePath := filepath.Join(fullPath, fu.FormattedPath())
1181
1182                                         hlFile, err := newFileWrapper(s.FS, filePath, 0)
1183                                         if err != nil {
1184                                                 return err
1185                                         }
1186
1187                                         rLogger.Infow("Starting file transfer", "path", filePath, "fileNum", i+1, "fileSize", binary.BigEndian.Uint32(fileSize))
1188
1189                                         incWriter, err := hlFile.incFileWriter()
1190                                         if err != nil {
1191                                                 return err
1192                                         }
1193
1194                                         rForkWriter := io.Discard
1195                                         iForkWriter := io.Discard
1196                                         if s.Config.PreserveResourceForks {
1197                                                 iForkWriter, err = hlFile.infoForkWriter()
1198                                                 if err != nil {
1199                                                         return err
1200                                                 }
1201
1202                                                 rForkWriter, err = hlFile.rsrcForkWriter()
1203                                                 if err != nil {
1204                                                         return err
1205                                                 }
1206                                         }
1207                                         if err := receiveFile(rwc, incWriter, rForkWriter, iForkWriter, fileTransfer.bytesSentCounter); err != nil {
1208                                                 return err
1209                                         }
1210
1211                                         if err := os.Rename(filePath+".incomplete", filePath); err != nil {
1212                                                 return err
1213                                         }
1214                                 }
1215
1216                                 // Tell client to send next fileWrapper
1217                                 if _, err := rwc.Write([]byte{0, dlFldrActionNextFile}); err != nil {
1218                                         return err
1219                                 }
1220                         }
1221                 }
1222                 rLogger.Infof("Folder upload complete")
1223         }
1224
1225         return nil
1226 }