Class: VagrantPlugins::Parallels::GuestLinuxCap::MountParallelsSharedFolder

Inherits:
Object
  • Object
show all
Extended by:
Util::UnixMountHelpers
Defined in:
lib/vagrant-parallels/guest_cap/linux/mount_parallels_shared_folder.rb

Class Method Summary collapse

Methods included from Util::UnixMountHelpers

detect_owner_group_ids, emit_upstart_notification, extended, find_mount_options_id, merge_mount_options

Class Method Details

.mount_parallels_shared_folder(machine, name, guestpath, options) ⇒ Object

Mounts Parallels Desktop shared folder on linux guest

Parameters:

  • machine (Machine)
  • name (String) —

    of mount

  • path (String) —

    of mount on guest

  • hash (Hash) —

    of mount options



17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
 
# File 'lib/vagrant-parallels/guest_cap/linux/mount_parallels_shared_folder.rb', line 17

def self.mount_parallels_shared_folder(machine, name, guestpath, options)
  # Sanity check for mount options: we are not supporting
  # VirtualBox-specific 'fmode' and 'dmode' options
  if options[:mount_options]
    invalid_opts = options[:mount_options].select do |opt|
      opt =~ /^(d|f)mode/
    end

    if !invalid_opts.empty?
      raise Errors::LinuxPrlFsInvalidOptions, options: invalid_opts
    end
  end

  guest_path = Shellwords.escape(guestpath)
  mount_type = options[:plugin].capability(:mount_type)

  @@logger.debug("Mounting #{name} (#{options[:hostpath]} to #{guestpath})")

  mount_options, mount_uid, mount_gid = options[:plugin].capability(:mount_options, name, guest_path, options)
  # In Parallels 20.2.0, prl_fs is removed and shares stop working with the
  # `mount` command.  Using prl_fsd fixes this issue.

  # prl_fsd does not support the _netdev option, so we need to remove it from the mount options
  # for supported mount_options check prl_fsd --help in guest machine after installing Parallels Tools
  
  # the `share` option needs to be passed as an extra `--share` argument

  prl_fsd_mount_options = mount_options.split(',').reject { |opt| opt == '_netdev' }

  prl_fsd_mount_options << "big_writes"
  prl_fsd_mount_options << "fsname=#{name}"
  prl_fsd_mount_options << "subtype=prl_fsd"

  if mount_options.include?('share')
    share_flag = '--share'
    prl_fsd_mount_options.reject! { |opt| opt == 'share' || opt.start_with?('uid=', 'gid=') }
  else
    share_flag = ''
  end

  o_options = prl_fsd_mount_options.join(',')

  mount_command = <<-CMD
    if [ -f /usr/bin/prl_fsd ]; then
      prl_fsd #{guest_path} -o #{o_options} #{share_flag} --sf=#{name}
    else
      mount -t #{mount_type} -o #{mount_options} #{name} #{guest_path}
    fi
  CMD

  # Create the guest path if it doesn't exist
  machine.communicate.sudo("mkdir -p #{guest_path}")

  # Attempt to mount the folder. We retry here a few times because
  # it can fail early on.
  stderr = ""
  retryable(on: Errors::ParallelsMountFailed, tries: 3, sleep: 5) do
    machine.communicate.sudo(mount_command,
      error_class: Errors::ParallelsMountFailed,
      error_key: :parallels_mount_failed,
      command: mount_command,
      output: stderr,
    ) { |type, data| stderr = data if type == :stderr }
  end

  emit_upstart_notification(machine, guest_path)
end

.prepare_psf_services(machine) ⇒ Object 



94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/vagrant-parallels/guest_cap/linux/mount_parallels_shared_folder.rb', line 94

def self.prepare_psf_services(machine)
  # Parallels Tools for Linux includes native auto-mount script,
  # which causes loosing some of Vagrant-relative shared folders.
  # So, we should to disable this behavior. [GH-102]

  auto_mount_script = '/usr/bin/prlfsmountd'
  if machine.communicate.test("test -f #{auto_mount_script}")
    machine.communicate.sudo(
      "echo -e '#!/bin/sh\n'" +
        '# Shared folders auto-mount is disabled by Vagrant ' +
        "> #{auto_mount_script}")
  end
end

.unmount_parallels_shared_folder(machine, guestpath, options) ⇒ Object 



85
86
87
88
89
90
91
92
 
# File 'lib/vagrant-parallels/guest_cap/linux/mount_parallels_shared_folder.rb', line 85

def self.unmount_parallels_shared_folder(machine, guestpath, options)
  guest_path = Shellwords.escape(guestpath)

  result = machine.communicate.sudo("umount #{guest_path}", error_check: false)
  if result == 0
    machine.communicate.sudo("rmdir #{guest_path}", error_check: false)
  end
end