---
name: "VCP::Utils::vss"
section: "3pm"
platform: "linux"
package: "libvcp-perl"
version: "0.9-20050110-1"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/VCP::Utils::vss"
---

# VCP::Utils::vss(3pm)

utilities for dealing with the vss command

## NAME

VCP::Utils::vss - utilities for dealing with the vss command

## SYNOPSIS

```
   use VCP::Utils::vss ;
```

## DESCRIPTION

A mix-in class providing methods shared by VCP::Source::vss and VCP::Dest::vss, mostly wrappers for calling the vss command.

## METHODS

- ssdir

  The location of the VSS database, if set in either the SSDIR environment variable or in the source or destination specification.

- ssuser

  The location of the VSS database, if set in either the SSUSER environment variable or in the source or destination specification.

- ss

  Calls the vss command with the appropriate vssroot option.

TODO: See if we can use two different users to do vss-\>vss.  Not sure if VSS sets the cp and workfold per machine or per user.

- throw\_undocheckout\_and\_retry

  This is called from the stderr\_filter for SS.EXE commands that  emit a "File ... is checked out by ..." message so that VCP can issue an undocheckout command and retry, like the Recover command.

- ss\_cp

  ```
      $self->ss_cp( $project );
  ```

Changes to a new current project, does not change projects if this is the current project.

- parse\_vss\_repo\_spec

  parse repo\_spec by calling parse\_repo\_spec, then set the repo\_id.

- create\_vss\_workspace

  Creates a temporary directory.

- get\_vss\_file\_list

  Retrieves a list of all files and directories under a particular path.  We need this so we can tell what dirs and files need to be added.

- vss\_files

  ```
      @files = $self->vss_files;
  ```

returns a list of all files (not projects) that *get\_vss\_file\_list()* loaded.

- vss\_file\_is\_deleted

  Returns 1 if the file is a deleted file.

NOTE: in VSS a file may be deleted and not deleted at the same time! Thanks to Dave Foglesong for pointing this out.

- vss\_file\_is\_active

  Returns 1 if the file is an active (undeleted) file.

NOTE: in VSS a file may be deleted and active at the same time! Thanks to Dave Foglesong for pointing this out.

## COPYRIGHT

Copyright 2000, Perforce Software, Inc.  All Rights Reserved.

This module and the VCP package are licensed according to the terms given in the file LICENSE accompanying this distribution, a copy of which is included in vcp.